home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / lvcat35m.zip / LIVECATM.DOC < prev    next >
Text File  |  1992-04-07  |  147KB  |  3,688 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.                                 LiveCat Ver 3.1/M
  19.             A Live Program External Menu System and Execution Monitor
  20.                                        for
  21.                             Multi User Wildcat! 3.xx
  22.  
  23.                               LIMITED TEST DRIVE VERSION
  24.  
  25.                   Copyright 1988, 89, 90, 91, 92 Stephen L. Cox
  26.                                All Rights Reserved
  27.                            A Live Systems Presentation
  28.        
  29.  
  30.        [[ ACKNOWLEDGMENTS ]]
  31.  
  32.        * Card Guppies, (c) Doug Peterson
  33.        * RBBS-PC (c) Ted Mack,
  34.        * Power Struggle (c) The LRSG Software Group
  35.        * Trade Wars II (c) Chris Sherrick
  36.        * TheDraw (tm) (c) TheSoft Programming Services and Ian E. Davis
  37.          Walnut Creek, Ca.
  38.        * QuickBBS (tm) (c) Adam Hudson, Arvada, Co.
  39.        * GAP (tm) (c) Gap Development Co., Laguna Nigel Ca.
  40.        * PCBoard (tm) (c) Clark Development Co., Salt Lake City Ut.
  41.        * Wildcat! (tm) (c) Mustang Software,  Bakersfield CA.
  42.        * Spitfire (tm) (c) 1988 Buffalo Creek Software, Des Moines IA.
  43.        * DOORWAY (tm) (c) 1987-89, Marshall Dudley
  44.        * 'C' 6.0 and Macro Assembler 5.1 (c) Microsoft Corporation, Redmond WA.
  45.        * DESQView (tm) (c) Quarterdeck Office Systems, Santa Monica, CA.
  46.        * Lantastic (tm) (c) Artisoft Inc, Tucson, AZ.
  47.        * Novell Netware (tm) (c) Novell Inc., Provo Utah.
  48.  
  49.        LiveCat 3.1 is written in Microsoft 'C' V 6.0 and Microsoft Macro
  50.        Assembler V 5.1.
  51.  
  52.        Portions of LiveCat 3.1 utilize the Ctree File Handler, copyright
  53.        1988 by Faircom and are the proprietary and confidential property
  54.        of Faircom Inc., Columbia, Mo.
  55.  
  56.        THE PRELIMINARIES:
  57.  
  58.        [[[ Limited License ]]]
  59.  
  60.        This software is copyrighted commercial software and may NOT be
  61.        distributed in any way.
  62.  
  63.         LiveCat 3.1/M (tm)
  64.         Copyright 1988,1989,1990, 1991 by Stephen L. Cox
  65.         All Rights Reserved
  66.  
  67.         Distributed by:
  68.                Live Systems
  69.                3800 Old Cheney Road
  70.                Suite 101-133
  71.                Lincoln, Ne.
  72.                68516
  73.  
  74.           With registration you receive:
  75.           Full registered copy of the latest version of LiveCat
  76.           Program support
  77.           Updates via Flite-Line Download
  78.  
  79.  
  80.  
  81.        [[[ Warranty ]]]
  82.  
  83.          The LiveCat  system is  provided "AS  IS" without  warranty of any
  84.        kind, either  expressed or  implied, including,  but not  limited to
  85.        the  implied  warranties  of  merchantability  and  fitness  for any
  86.        purpose.  The entire risk as to the quality and performance of  this
  87.        program is  with the  user and  should the  program prove defective,
  88.        the  user  and  not  the  author  will assume all responsibility for
  89.        correcting all information.  The  author does not warrant that  this
  90.        program will  function in  the desired  mode or  will meet any users
  91.        requirements or  that the  operation of  the program  will be  error
  92.        free.
  93.  
  94.        THE INSTALLATION OF LIVECAT ON YOUR SYSTEM CONSTITUTES ACCEPTANCE
  95.        OF THE ABOVE TERMS *
  96.  
  97.        This version of  LiveCat 3.1 is  designed to work  in both a  single
  98.        user and Multi-User BBS  environment.  Depending on the version you
  99.        registered, it may be simultaneously executed on from 1 to 99 nodes
  100.        of a SINGLE BBS SYSTEM ONLY.
  101.  
  102.                               THANKS TO THE FOLLOWING:
  103.  
  104.        I  am   deeply  indebted   to  the   following  people   for   their
  105.        participation in the  beta testing phase  of LiveCat. Without  their
  106.        efforts this product would not  have been possible... Thanks to  all
  107.        of you!
  108.  
  109.  
  110.          Don Gump, Silicon Alternative,          Fort Wayne IN.
  111.          Herb Mellinger, The Silicon Lab,        Hudson     FL.
  112.          Rick Kingslan, The Omaha Connection,    Omaha      NE.
  113.          Jacque Shipley, The Mother Board,       Des Moines, IA.
  114.          Ira Lichtenstein, Sing Sing Sing,       Ossining, NY.
  115.          Bob Gibson, Life Line BBS,              Los Angeles, CA.
  116.          Dr. Hugh Mitchell, Doctor on Board BBS, St. Catharines Ontario
  117.          Bernard Sincennes, Alley Cat BBS        Montreal, Quebec
  118.          Dale Allen, Truck Stop BBS,             Houston, TX
  119.          Ron King, The Drag Strip,               Hopkinsville KY.
  120.          Larry Solheim, Opus Information Systems Richfield, MN
  121.          Larry Easley, The Ranch House BBS,      Lunenberg MA.
  122.          Ron Alspaugh, Hotlanta BBS              Atlanta GA.
  123.          Tim Wool, Express Line BBS              Winterville GA.
  124.  
  125.         LiveCat 3.1 is dedicated to my wife Pam, who has (almost)  silently
  126.        endured the  hundreds of  hours of  'Computer Widowhood'  imposed by
  127.        this project over the years.
  128.  
  129.         [[ TABLE OF CONTENTS ]]
  130.  
  131.        INTRODUCTION .............................................. 7
  132.  
  133.        ORGANIZING YOUR BBS ....................................... 10
  134.  
  135.        FIRST TIME INSTALLATION ................................... 14
  136.  
  137.        CREATING NEW MENUS ........................................ 20
  138.  
  139.        INSTALLING DOORS IN MENUS ................................. 22
  140.  
  141.        EDITING DOORS ALREADY INSTALLED IN THE SYSTEM ............. 30
  142.  
  143.        APPENDIX A - FIELDS IN THE CONFIGURATION PROGRAM .......... 31
  144.  
  145.        APPENDIX B - MENU NAMING, CREATION AND SECURITY ........... 36
  146.  
  147.        APPENDIX C - SUPPORTED DOOR TYPES AND CODES ............... 39
  148.  
  149.        APPENDIX D - DTE LOCK/UNLOCK FUNCTIONS AND USE ............ 40
  150.  
  151.        APPENDIX E - USING REPLACABLE SCRIPT PARAMETERS ........... 41
  152.  
  153.        APPENDIX F - HOW VARIOUS DOOR TYPES ARE CONFIGURED......... 43
  154.  
  155.        APPENDIX G - RUNNING SUB-COPIES OF WILDCAT AS FORUMS ...... 47
  156.  
  157.        APPENDIX H - LIVECAT AND LSEDIT FUNCTION KEYS.............. 51
  158.  
  159.        APPENDIX I - OPTIONAL ANSI AND ASCII MENUS ................ 53
  160.  
  161.        APPENDIX J - UTILITY AND SUPPORT PROGRAMS ................. 54
  162.  
  163.        APPENDIX K - DOOR HINTS AND TIPS .......................... 55
  164.  
  165.        PROBLEMS, QUESTIONS AND ANSWERS ........................... 57
  166.  
  167.        LIVECAT REGISTRATION INFORMATION .......................... 58
  168.  
  169.          INTRODUCTION
  170.  
  171.          Welcome to the wonderful world of LiveCat!!  LiveCat 3.1  provides
  172.        COMPLETE external menu and execution control of doors running  under
  173.        WILDCAT 1.13+  and up.   It adds  many useful  features to WILDCAT's
  174.        slim support of doors. Here are a few of the highlights of version
  175.        3.1..
  176.  
  177.        *EXTERNAL MENUS -  Registered versions provide 64 menus of 22
  178.                           entries each.  Shareware versions provide 2
  179.                           menus of 4 entries each.  Allows up to 1408
  180.                           total doors in system
  181.  
  182.        *NO BATCH FILES -  Execute Wildcat!, RBBS and PCBoard, GAP and many
  183.                           other doors without batch files.
  184.  
  185.        *RE-ENTRANT MENUS - All doors return to MENU instead of WILDCAT
  186.                            FAST!!
  187.  
  188.        *USER SELECTABLE MENUS - Users select new menus without return to
  189.                                 WILDCAT
  190.  
  191.        *AUTO LOCAL SUPPORT - Runs MOST doors in LOCAL mode automatically
  192.  
  193.        *RE-RUN LOCKING - Lock out multiple daily runs of each individual
  194.                          door!  Allow any door to be run from 1 to 9
  195.                          times daily
  196.  
  197.        *TIME CONTROL - Control the time users can spend in individual
  198.                        doors
  199.  
  200.        *SECURITY CONTROL - Control security level for each individual
  201.                            door AND menu!
  202.  
  203.        *MULTI-LEVEL TIME LIMITS - Different time limits for different
  204.                                   security!
  205.  
  206.        *FULL Support of High Speed Modems - Lock/Unlock DTE on the fly!
  207.                                             at baud rates to 38400.
  208.  
  209.        *UP/DOWNLOAD RATIO DETECTION - Lock doors on ratios -
  210.                                       multi-level-optional
  211.  
  212.        *VAULT TIME LOCK - Lock doors completely during certain hours of
  213.                           the day!
  214.  
  215.        *FULL FEATURED EDITOR - Includes LsEdit to construct and edit
  216.                                menus.
  217.  
  218.        *FULL MULTI-USER OPERATION
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.        LiveCat Version 3.1             6                     06-09-91
  232.  
  233.         The real reason LiveCat was developed was to control time usage  on
  234.        my extremely  active BBS  system and  to better  organize the entire
  235.        doors system.
  236.  
  237.         I currently run about  70 doors and have  found it to be  a problem
  238.        because of the  addictive nature of  the games, especially  those of
  239.        the caliber  of Trade  Wars 500.   I wanted  to encourage  users  to
  240.        spend  at  least  part  of  their  daily time participating in other
  241.        sections  of  the  BBS  besides  the  games.   I had dozens of users
  242.        logging in and playing out their entire daily time allotment in  the
  243.        doors and never doing anything else.
  244.  
  245.         My reasoning was that if a  user is limited to a certain  amount of
  246.        time  that  is  something  less  than  their  daily board time, they
  247.        might, just might,  spend their remaining  time doing other  things.
  248.        Experience with it's predecessor  LiveMon has shown this  assumption
  249.        to be correct.  The success  with LiveMon led to the plan  to expand
  250.        it into the  full blown door  monitor that you  are now looking  at,
  251.        LiveCat!
  252.  
  253.         LiveCat operates as a door  program itself although a very  special
  254.        one.   It's purpose  is to  tightly control  the execution  of other
  255.        doors within your  system. It organizes  your doors into  categories
  256.        that let you place like games in specific menus. It also allows  you
  257.        to place a specific door in more than one menu.
  258.  
  259.          The menu layouts  follow those of  WILDCAT closely so  they should
  260.        present your users no  problems.  You may  have upto 64 menus  of 22
  261.        entries each or 1408 doors total  in your system. Try doing THAT  in
  262.        your WILDCAT DOORS menu. The  Shareware version allows 2 menus  of 4
  263.        entries each.
  264.  
  265.         Doors executed within the LiveCat environment are no longer  forced
  266.        to return back to the BBS upon termination thereby forcing the  user
  267.        to go  through the  log-on sequence  repeatedly.   Return from  each
  268.        door is back to the LiveCat menu from where the user started.   This
  269.        saves  a  great  deal  of  time  for  the  user and provides greater
  270.        execution control for  the sysop.   Users may change  menus and move
  271.        around  at  will,  selecting  any  door  your  system  has available
  272.        without returning to the main board.
  273.  
  274.         LiveCat provides built in support  for door programs written to  be
  275.        run under several types of BBS  systems.  Most of the doors  we have
  276.        available  today  were  designed  to  run  under  either the PCBoard
  277.        system or RBBS-PC.
  278.  
  279.          Running doors for  other systems under  WILDCAT can be  tedious at
  280.        best and  capable of  producing cardiac  arrest at  worst!   LiveCat
  281.        does it's  best to  make this  task easier.   It will  automatically
  282.        produce all the  conversion files necessary  to run doors  for these
  283.        other systems.
  284.  
  285.          Doors for most  all versions of  Wildcat, PCBoard 11.x  thru 14.x,
  286.        doors for the newer  versions of RBBS 15.1C  and up, GAP doors,  and
  287.        QBBS doors are supported. Most of them even in the LOCAL mode!   And
  288.        with our  exclusive Script  Language called  LSSL, you  can run most
  289.        any door  known by  passing it  the command  line it  needs directly
  290.        from LiveCat.
  291.  
  292.  
  293.  
  294.  
  295.        LiveCat Version 3.1             7                     06-09-91
  296.  
  297.         The  time  monitoring  features  of  LiveCat  allow  you to set the
  298.        maximum  amount  of  time  a  user  may  spend  in  doors  each day.
  299.        Additionally each  individual door  may have  a time  limit for each
  300.        access by the user.  These time limits are independent of the  daily
  301.        WILDCAT time  limit controlled  by the  users security  level.   The
  302.        timing features are multi-level in that users with different  levels
  303.        of security can be given different time allocations within LiveCat.
  304.  
  305.         LiveCat provides  full security  control of  all the  doors in your
  306.        system.   You can  attach a  security level  to each  door that will
  307.        prevent users with  lower or higher  security levels from  executing
  308.        it. This can be set for EACH door in your system.
  309.  
  310.         You might for  instance have a  few doors that  could be considered
  311.        adult doors and you do not  want them accessed by users without  the
  312.        proper clearance and  verification.  Or,  you might have  some doors
  313.        that you want  available only to  registered or contributing  users.
  314.        You can assign those doors a security level that would let only  the
  315.        selected levels access them.
  316.  
  317.         LiveCat also provides  a feature called  'Vault Time Lock'  or VTL.
  318.        This feature allows you to  completely lock your door system  to ALL
  319.        users between certain hours of the day.
  320.  
  321.         Ever suffered the frustration of trying to get onto your own  board
  322.        during the  day to  do maintenance  from some  remote location,  and
  323.        couldn't get  on because  Joe was  playing out  50 Trade Wars turns?
  324.        LiveCat  can  alleviate  this  problem  by  making it impossible for
  325.        users to enter the  doors between the times  you set.  This  will at
  326.        least keep  gaming activity  from interfering  during your  selected
  327.        times.  The lock time can be as  short as 1 minute or as long as  23
  328.        hours and 59 minutes.  You should be able to find a time slice  that
  329.        will meet your needs.
  330.  
  331.         LiveCat also  provides a  feature called  'UDR' or  Upload/Download
  332.        Ratio monitoring.   This feature will  allow you to  optionally lock
  333.        the doors system to users  who have exceeded the pre-set  up/dn load
  334.        ratios.
  335.  
  336.         One other feature worth mentioning that LiveCat provides to you  is
  337.        Re-Run locking.   You may  mark any  door in  your system  as a 'run
  338.        once only' door  and the user  will automatically be  prevented from
  339.        accessing it more than once a  day.  Or, optionally you can  allow a
  340.        door  to  be  run  from  1  to  9  times  daily depending on how you
  341.        configure it.   Nice for  the addicts  out there  that never  get  a
  342.        chance to see what else you have because they can't tear  themselves
  343.        away from Star Traders or whatever.
  344.  
  345.         That pretty well  sums up what  LiveCat is and  what it can  do for
  346.        you.   While  the  features  that  it  provides are extensive, it is
  347.        relatively easy to set up and run.
  348.  
  349.         I have provided a full featured editor for the menu system to  make
  350.        the task of door installation into LiveCat nearly painless.  I  hope
  351.        you  enjoy  it.   If  it  proves  useful  to you and your users then
  352.        please register it and encourage me to continue to enhance it.
  353.  
  354.         I believe that LiveCat will  prove to be a valuable  enhancement to
  355.        an already superb piece of software, Wildcat!.
  356.  
  357.  
  358.  
  359.        LiveCat Version 3.1             8                     06-09-91
  360.  
  361.        [[ LIVECAT FILES IN PACKAGE ]]
  362.  
  363.         The package you downloaded  should contain the following  files. If
  364.        any of  the files  listed below  were not  included, call Flite-Line
  365.        BBS to download the latest Shareware version:
  366.  
  367.          A * denotes files in the registered systems only!
  368.  
  369.                LIVECAT.EXE      The main menu/monitor system Version 3.1/M
  370.                 LSEDIT.EXE      V 3.1/M of the menu editor
  371.                  LSFIP.EXE      The Time Converter and execution profiler
  372.               LSCONFIG.EXE      System Configuration program
  373.               LIVECATM.DOC      This documentation.
  374.                 LSRBLD.EXE      Reconstructs damaged indexes
  375.                 README.1ST      Last minute notes not in the documentation
  376.                  DOORS.BBB      Example DOOR MENU for your WILDCAT system
  377.                  DOORx.BAT      Sample .BAT to run LiveCat with WILDCAT
  378.  
  379.  
  380.                Files created at runtime by the LsEdit editor:
  381.                MNAMES.LST       Menu names and security levels
  382.                SCRIPT.IDX       LiveCat 3.1 Database Index
  383.                SCRIPT.DAT       LiveCat 3.1 Database file
  384.                ATTRIB.IDX       LiveCat 3.1 Database Index
  385.                ATTRIB.DAT       LiveCat 3.1 Database file
  386.                ******.IMG       Menu Images for runtime operation
  387.               MONITOR.CFG       Configuration file all LiveCat components
  388.               MONITOR.DAT       Security level timing parameters
  389.  
  390.               During execution both LsEdit and LiveCat will create and delete
  391.               swap files on your disk, or in EMS if selected.  These files are
  392.               erased at the end of each run.
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.  
  407.  
  408.  
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.        LiveCat Version 3.1             9                     06-09-91
  424.  
  425.        [[ ORGANIZING YOUR BBS TO RUN DOORS UNDER LIVECAT ]]
  426.  
  427.          * PLANNING YOUR INSTALLAION *
  428.  
  429.          Before  you  actually  install  LiveCat  and  start start building
  430.        menus  for  it,  you  need  to  spend  some  time thinking about and
  431.        planning how you will organize your doors.
  432.  
  433.         In order to  make this system  perform for you  there MUST be  SOME
  434.        logic to  your board  setup.   The applies  MAINLY to  the directory
  435.        names you use  for your NODES  and to the  .CFG file names  for your
  436.        DOORS.
  437.  
  438.         In  a  MULTI-NODE  system,  the  IDEAL  configuration  is  one that
  439.        follows  DIRECTORY  NAMING  conventions  that  have  a  NODE  NUMBER
  440.        relationship!
  441.  
  442.         Because of the new script language  and the fact that you now  have
  443.        replacable script  parameters you  MUST think  carefully about  how
  444.        some of these things relate to one another.
  445.  
  446.        Now,  before  we  go  any  further,  lets  take a look at an IDEALLY
  447.        mapped configuration of Wildcat! and LiveCat working together.
  448.  
  449.        \WC30 (contains Wildcat! and LiveCat .EXE files!)
  450.         |+------------------------+------------------+-------------------->
  451.         |                                            |
  452.          DOORx.BAT                                   |
  453.          \WCWORK                                      \LIVECAT
  454.           |                                            lcuser.dat
  455.           \NODE1             \NODE2..x                 monitor.dat
  456.            MONITOR.CFG        MONITOR.CFG              *.img
  457.            LC.SYS             LC.SYS                   *.idx
  458.                                                        *.dat
  459.                                                        *.bbs
  460.                                                        *.scr
  461.                                                        menu.ans
  462.                                                        menu.bbs
  463.                                                         |
  464.                                                          \BULL
  465.                                                           blt.bbs
  466.                                                           blt.scr
  467.  
  468.         As you can see, the NODEx directories EACH have the node number  in
  469.        their name.   The diagram shown above is how Wildcat! 3.0 installs
  470.        itself by default.  All you need do is add the LiveCat directory to
  471.        the tree and you're ready to go, you may ALSO use the  above map as a
  472.        guide to the correct  placement of ALL the LiveCat related files.
  473.  
  474.        Study the above diagram carefully and make any changes to your
  475.        Wildcat! installation that might be necessary.
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.        LiveCat Version 3.1             10                     06-09-91
  488.  
  489.         LiveCat can  keep everything  orderly for  you only  if you do your
  490.        planning!   In  LiveCat,  everything  is  oriented  around  a   MENU
  491.        concept, that is,  several doors attached  to a single  menu that is
  492.        displayed to a user.  When inside a LiveCat menu, a user can  either
  493.        PICK A DOOR TO RUN or CHANGE TO A DIFFERENT MENU.
  494.  
  495.         Running under LiveCat  it is best  to categorize all  of your
  496.        doors into specific themes  such as WAR  GAMES, Trivia Games, Board
  497.        Games and so on.
  498.  
  499.         The  FIRST  step  in  setting  up  a  LiveCat system is to create a
  500.        Wildcat!  DOORS.BBS FILE that  presents the user a selection  of all
  501.        these categories, and then you will  want to take care to place  all
  502.        the doors of the same type into the appropriate LiveCat menu.
  503.  
  504.        Here is a reproduction of the WILDCAT DOORS Menu I use on my
  505.        system.
  506.                         Flite-Line-On-Line
  507.        "DoorWays to Other Places in the Flite-Line World"
  508.  
  509.           DOOR #1         DOOR #2         DOOR #3         DOOR #4
  510.        ┌───────────┐   ┌───────────┐   ┌───────────┐   ┌───────────┐
  511.        │  ╔═════╗  │   │  ╔═════╗  │   │  ╔═════╗  │   │  ╔═════╗  │
  512.        │  ╚═════╝  │   │  ╚═════╝  │   │  ╚═════╝  │   │  ╚═════╝  │
  513.        │          Θ│   │          Θ│   │          Θ│   │          Θ│
  514.        │  WAR      │   │ ADVENTURE │   │  TRIVIA   │   │ EASY FUN  │
  515.        │   GAMES   │   │    GAMES  │   │    GAMES  │   │   GAMES   │
  516.        └───────────┘   └───────────┘   └───────────┘   └───────────┘
  517.  
  518.           DOOR #5         DOOR #6         DOOR #7
  519.        ┌───────────┐   ┌───────────┐   ┌───────────┐
  520.        │  ╔═════╗  │   │  ╔═════╗  │   │  ╔═════╗  │
  521.        │  ╚═════╝  │   │  ╚═════╝  │   │  ╚═════╝  │
  522.        │          Θ│   │          Θ│   │          Θ│
  523.        │DATABASE   │   │SIMULATIONS│   │ GAMES OF  │
  524.        │  UTILITIES│   │           │   │  CHANCE   │
  525.        └───────────┘   └───────────┘   └───────────┘
  526.          GAME INSTRUCTIONS ARE AVAILABLE FOR DOWNLOAD IN FILE AREA 'K
  527.  
  528.          The   above   example   illustrates   the   categorization  of   a
  529.        LiveCat system that could  have up to  154 doors, or  22 entries  in
  530.        each of the 7 categories.
  531.  
  532.         The door numbers shown in  the DOORS.BBS MENU each correspond  to a
  533.        DOORx.BAT file in the \WC30 directory  required to start  LiveCat
  534.        with the indicated menu as the default.
  535.  
  536.         You  should  NOW  decide  how  many  major categories of doors your
  537.        system will  have and  decide on  a NAME  for each  menu.
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.        LiveCat Version 3.1             11                     06-09-91
  552.  
  553.         In dealing with  a MULTI-NODE installation,  it's probably best  to
  554.        concentrate on getting ONE NODE going first with a couple of  doors,
  555.        THEN go ahead and set up the remaining nodes.  All that is  required
  556.        for the second  node is a  configuration file in  the node directory
  557.        that points  to where  the LiveCat  database is  located, all  nodes
  558.        share  this  same  database  and  it  makes  running  doors  in  the
  559.        Multi-Node environment a  dream because you  only have to  do things
  560.        ONCE no matter HOW many nodes you will eventually have.
  561.  
  562.        In this documentation I  refer to A CATEGORY  name and a MENU  name,
  563.        they are the SAME  THING.  A category  or menu name must  follow all
  564.        the rules of a  DOS FILE NAME, 8  characters or less, no  spaces and
  565.        alphanumeric characters .
  566.  
  567.         These category names  will be displayed  to the user  when they are
  568.        inside  LiveCat  so  they  should  be  descriptive.   Door #1 on our
  569.        example Menu  screen is  WAR GAMES.   Inside this  category we might
  570.        have Trade Wars II, Power Struggle, Galactic Conquest and other  war
  571.        game doors.  It seems that a logical name for this menu or  category
  572.        might be WARGAMES, right?  Right  now, decide on the names that  you
  573.        will  use  for  the  menu  categories  you decided on and write them
  574.        down.
  575.  
  576.          Now that  we have  decided how  many categories  we will  have and
  577.        what their names  are, we must  construct one DOORx.BAT  file in the
  578.        x:\WC30 directory  for each  of them.   This DOORX.BAT  file is VERY
  579.        simple, and remember,  at this time  we are NOT  concerned about the
  580.        names of the actual doors you will run on your system!  We are  ONLY
  581.        concerned  with  what  the  name  of  the  MENU will be that holds a
  582.        selection of doors.
  583.  
  584.         Again, using door #1 in  our example screen above, named  WARGAMES,
  585.         here's what DOOR1.BAT would look like.
  586.  
  587.             LIVECAT MONITOR.CFG WARGAMES <--- DIFFERENT IN EACH DOORx.BAT
  588.             CD \WC30                        | BUT ONLY THE MENU NAME IS
  589.                                             | DIFFERENT
  590.  
  591.         See, very simple!   Construct one of  these DOORx.BAT files  in the
  592.        \WC30 directory to correspond to the number and name of each of  the
  593.        categories in your  proposed DOORS.BBS DOORS  Menu.  Each  DOORx.BAT
  594.        file is IDENTICAL with the  exception of the MENU NAME  as indicated
  595.        by  the  arrowed  line  above.   If  this  were  DOOR2.BAT  the only
  596.        difference would  be that  the indicated  line would  read:  LIVECAT
  597.        MONITOR.CFG ADVENTUR instead of WARGAMES.
  598.  
  599.         It is EXTREMELY IMPORTANT that the commands to CD back to the
  600.        \WC30 directory be in the proper place or you will have a mess!  If
  601.        you previously had doors running on your system and you ever got
  602.        your directory changes wrong you will understand what I'm saying.
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609.  
  610.  
  611.  
  612.  
  613.  
  614.  
  615.        LiveCat Version 3.1             12                     06-09-91
  616.  
  617.         Once you have determined what  your menu categories will be,  named
  618.        them and constructed a DOORX.BAT file for each of them, make a  list
  619.        of the doors that you will  include in each category and write  down
  620.        the category name, you will  need all this information to  construct
  621.        your LiveCat menus with the editor.
  622.  
  623.        We can now proceed to physical installation of LiveCat 3.1!
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674.  
  675.  
  676.  
  677.  
  678.  
  679.        LiveCat Version 3.1             13                     06-09-91
  680.  
  681.         [[ INSTALLATION OF MULTI USER LIVECAT 3.1 FOR THE FIRST TIME ]]
  682.  
  683.         We have  tried to  make the  installation of  LiveCat 3.1 as simple
  684.        and painless as possible  for you.    There are a certain number  of
  685.        steps that you MUST   follow to the letter  in order to guarantee  a
  686.        successful install.  Here is a  brief overview of the steps we  will
  687.        perform:
  688.  
  689.             Step 1:   Create a  LIVECAT directory  on your  hard disk  that
  690.                       will hold all of the 3.1 files.
  691.  
  692.             Step 2:   Run a CONFIGURATION  program will create  the version
  693.                       3.1 database files and configuration information.
  694.  
  695.             Step 3:  Create a couple of new menus and directories.
  696.  
  697.             Step 4:  Make a couple of configuration changes to your modem.
  698.  
  699.             Step 5:  Start up!
  700.  
  701.          As you can  see, it's not  a complicated process  and it shouldn't
  702.        take more than 30 minutes to  an hour to install, configure and  run
  703.        your first door, IF you  follow these instructions carefully.   From
  704.        that point on, a door can be installed in LiveCat and brought up  on
  705.        your system in a matter of minutes.
  706.  
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.  
  735.  
  736.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.  
  743.        LiveCat Version 3.1             14                     06-09-91
  744.  
  745.        [[ PHYSICAL INSTALLATION STEPS ]]
  746.  
  747.         Refer to the map given earlier of the system configuration to name
  748.        your directories and place the files during the following steps.
  749.  
  750.        Now, lets do it!
  751.  
  752.         Step 1:  Create new DIRECTORY called LIVECAT that is ONE  DIRECTORY
  753.                  DOWN from your \WC30 directory, ie:
  754.                  C:\WC30\LIVECAT
  755.  
  756.         Step 2:  If  you unzipped this package  (or copied from disk)  in a
  757.                  directory OTHER than  x:\WC30\LIVECAT, copy ALL  the files
  758.                  from this package to the \WC30\LIVECAT directory NOW,  and
  759.                  change to that directory before proceeding.
  760.  
  761.         Step 3:   There are  five .EXE  files associated  with LiveCat 3.1,
  762.                  they   are:      LIVECAT.EXE,    LSEDIT.EXE,    LSFIP.EXE,
  763.                  LSCONFIG.EXE and LSRBLD.EXE.  These .EXE files must be  in
  764.                  EITHER your x:\WC30 directory OR any directory that is  in
  765.                  your SEARCH PATH.  Copy the five .EXE files to the  chosen
  766.                  directory  now  and  delete  them from the x:\WC30\LIVECAT
  767.                  directory.
  768.  
  769.         Step 4:  Change directories to x:\WC30\WCWORK\NODE1
  770.  
  771.         Step 5:  TYPE: LSCONFIG to start up the System Installer
  772.  
  773.         Step 6:  You can refer to APPENDIX A for the exact format and
  774.                  description  of  each  field  that  you  are prompted
  775.                  for.
  776.  
  777.                  Answer EACH  of the  configuration questions  asked of you
  778.                  by  the  configuration  program.  It's  ESSENTIAL that you
  779.                  answer the  questions that  ask for  PATH NAMES correctly!
  780.  
  781.                  Instructions for  EACH field  are shown  at the  bottom of
  782.                  the screen and the data  you enter MUST match the  example
  783.                  format  in  the  instructions.   At  the  end  of the last
  784.                  configuration  question,  the  installer  will  give   the
  785.                  message:  Creating Isam Files'.
  786.  
  787.                  The 3.1 database  has now been  created and the  Main Pull
  788.                  Down Menu System of  LSEDIT will now appear.   Immediately
  789.                  press ESCAPE to get out of LSEDIT.  Do _NOT_ go  exploring
  790.                  around the editor at this  time!  Plenty of time  for that
  791.                  later.
  792.  
  793.         Step 7:  Change to the x:\WC30\LIVECAT directory and
  794.                  verify that the following files were created:
  795.                          SCRIPT..DAT           SCRIPT.IDX
  796.                          ATTRIB..DAT           ATTRIB.IDX
  797.                         LOKFILE..DAT           LCUSER..DAT
  798.                           MNAMES.LST           MONITOR.DAT
  799.  
  800.         If  these  files  were  not  created,  something  is wrong.
  801.        Check your procedures  and start again.   If the files  ARE
  802.        present everything is fine so far.
  803.  
  804.  
  805.  
  806.  
  807.        LiveCat Version 3.1             15                     06-09-91
  808.  
  809.         Step  8:  Now  change  back  to your x:\WC30\WCWORK\NODE1
  810.                 directory and verify  that  a  file  called  MONITOR.CFG
  811.                 exists there.
  812.  
  813.         Step 9: Change back to the x:\WC30\LIVECAT directory.
  814.  
  815.         Step 10: Creating the MENU.BBS file.  In a LiveCat door system  the
  816.                  user is allowed to select  new menus of doors by  pressing
  817.                  the 'Z' key.  You must  now create at least ONE menu  file
  818.                  that will be shown to  the user when they press  'Z' while
  819.                  inside one  of your  LiveCat menus.   This file  is called
  820.                  MENU.BBS and is an ASCII  menu file.  You may  also create
  821.                  ANSI COLOR  file that  will be  displayed to  a user using
  822.                  color, it's name  is MENU.ANS.   LiveCat will detect  from
  823.                  the user settings which of  the files to use but  only the
  824.                  .BBS file is required.   In addition, you may have  a menu
  825.                  file,  both  ansi  and  ascii  that  are  security   level
  826.                  specific.  For instance  if you have some  protected menus
  827.                  that  you  want  to  display  to  LEVEL 50 users only, you
  828.                  could create a  MENU50.BBS and a  MENU50.ANS.  If  LiveCat
  829.                  finds a security specific  menu it will use  it, otherwise
  830.                  it will use the default.  Included with this package is  a
  831.                  SAMPLE MENU.BBS file for you to work from.  This  security
  832.                  system is described in more detail in APPENDIX B.
  833.                  Since most all of you have  a WAR GAME or two, like  Trade
  834.                  Wars 500, we  will use WARGAMES  as the name  of our first
  835.                  menu during this installation procedure.  You can add  new
  836.                  menus later on using exactly  the same procedure.  If  you
  837.                  don't understand the concept  of a 'LiveCat Menu',  reread
  838.                  the ORGANIZATION section of this document.
  839.  
  840.                  If  you  will  now  type  out  the  contents of the sample
  841.                  MENU.BBS  file  included  with  this  package you will see
  842.                  that the MENU A is described as War Games.  No need to  do
  843.                  anything  else  with  the  MENU.BBS  file  for  now,  just
  844.                  remember that it's there.
  845.  
  846.         Step  11:   If  you  will   remember  back  to  when  we  ran   the
  847.                   CONFIGURATION  options,  one  of  the  questions you were
  848.                   asked  was  if  you  wanted  to  use  the  SCORE BULLETIN
  849.                   feature.  LiveCat 3.1  has the ability to  handle scoring
  850.                   bulletins  in  much  the  same  manner as the BBS itself.
  851.                   This allows  you to  move all  your game  score bulletins
  852.                   out of the  main board area  and into the  LiveCat system
  853.                   where they belong.  This however IS an option.  In  order
  854.                   to USE the option you  must create a new directory  named
  855.                   BULL one level  below your x:\WC30\LIVECAT directory.
  856.  
  857.                   In  a  Wildcat!   system  this  directory  path  would be
  858.                   x:\WC30\LIVECAT\BULL.   If you  do NOT  wish to  use this
  859.                   option you do not have  to create the directory.   If you
  860.                   DO  want  to  use  this  feature you create the indicated
  861.                   directory and  in it  you must  place at  least 1 file, a
  862.                   file  called  BLT.BBS  which  is  the  MENU  of the score
  863.                   bulletins, or the equivalent  of what the user  would see
  864.                   if  they  typed  B  while  in  Wildcat!   for  a bulletin
  865.                   listing.  Create that menu  file and the score system  is
  866.                   configured.
  867.  
  868.  
  869.  
  870.  
  871.        LiveCat Version 3.1             16                     06-09-91
  872.  
  873.                   I included a sample BLT.BBS  file for you to start  from.
  874.                   If you use this feature you  will now have to go to  EACH
  875.                   door directory that produces a scoring bulletin and  tell
  876.                   it to  place the  bulletin in  \WC30\LIVECAT\BULL instead
  877.                   of the main  board bulletin area.   In addition, each  of
  878.                   the  score  bulletins  has  a  slightly  different naming
  879.                   convention than you might be  used to.  Bulletin #1  must
  880.                   be named  BLT1.BBS for  the ASCII  bulletin and  BLT1.SCR
  881.                   for the ANSI bulletin.  A matching ANSI is not  necessary
  882.                   but LiveCat  will use  it if  it finds  one otherwise  it
  883.                   will  use   the  ASCII   bulletin.    Using  the    above
  884.                   conventions  to  put  a  TRADE  WARS 500 scoring bulletin
  885.                   into  the  monitor  as  bulletin  #1, you would configure
  886.                   Trade    Wars    to     name    it's    bulletin     file
  887.                   x:\WC30\LIVECAT\BULL\BLT1.BBS,  the  BLT.BBS  menu   file
  888.                   would say:
  889.  
  890.                   1 .. Trade Wars 500 Scores, or what ever you choose.
  891.  
  892.                   Refer to the example files to get it straight.
  893.  
  894.         Step 12:  You must now  edit a file that was created  automatically
  895.                   during installation called MONITOR.DAT.  This file is
  896.                   in the x:\WC30\LIVECAT directory.
  897.  
  898.                   The MONITOR.DAT  file contains  a list  of EVERY SECURITY
  899.                   LEVEL IN USE ON YOUR WILDCAT SYSTEM.  It is crucial  that
  900.                   this file be set up correctly or improper times for  your
  901.                   users will result.
  902.  
  903.                   * NOTE *
  904.                   In Wildcat! 3.0, SECURITY PROFILES are used to hold a
  905.                   set of parameters relating to a particular user level.
  906.                   THE PROFILE NAME IS _NOT_ A SECURITY LEVEL, it is
  907.                   a NAME for a set of security attributes.  The SECURITY
  908.                   LEVEL is the MENU level of the PROFILE set by you when
  909.                   you define the profile.  Your WC1000 PROFILE for example
  910.                   will have a MENU LEVEL of 1000.  The 1000 is your
  911.                   actuall security level and THAT is the number that
  912.                   MUST be placed in the LiveCat MONITOR.DAT file.
  913.  
  914.                   During running of the configuration program this file
  915.                   was created with two  default security levels of 110 and
  916.                   1000.   THESE SHOULD  NOT BE  DELETED, even  if you
  917.                   don't USE 110 or 1000 on your BBS.
  918.  
  919.                   The format of this file is VERY simple, I'll use a  LEVEL
  920.                   20 user as an example.
  921.  
  922.                   The entry in MONITOR.DAT for  a level 20 user might  look
  923.                   like this:
  924.  
  925.                   20 60 75
  926.  
  927.                   The  number  20  is  obviously  the  SECURITY  LEVEL. The
  928.                   number 60 is the TOTAL  TIME ALLOWED ON THE BBS  EACH DAY
  929.                   FOR A LEVEL 20 USER.   The number 75, is a PERCENTAGE  of
  930.                   the NUMBER  60 that  you will  allow a  level 20  user to
  931.  
  932.  
  933.  
  934.  
  935.        LiveCat Version 3.1             17                     06-09-91
  936.  
  937.                   have for door usage each  day. In other words, the  above
  938.                   line states  that a  Level 20  user has  60 minutes total
  939.                   each day on  the BBS, of  that 60 minutes  you will allow
  940.                   75% of that to be used in doors.
  941.  
  942.                   The PERCENTAGE  field may  be ANY  percentage you  choose
  943.                   from 1% to 99%, but should NEVER be 100%... LiveCat  uses
  944.                   these fields  the FIRST  time a  user goes  into doors on
  945.                   any given day,  it calculates the  time they can  stay in
  946.                   doors and then keeps track of the door time used for  the
  947.                   day.  At midnight, the time rolls over and the user  will
  948.                   again be allowed the full percentage of time.
  949.  
  950.                   At this time, use a text editor and edit the MONITOR.DAT
  951.                   file to include the LEVEL TOTALTIME PERCENT numbers for
  952.                   every security level in use on your system, INCLUDING
  953.                   YOUR OWN SYSOP LEVEL.
  954.  
  955.         Step  13:   If  you  didn't  do  it  before,  we  now must create a
  956.                   DOOR1.BAT file  that will  be executed  by Wildcat!  when
  957.                   the user is in the BBS and types D for doors and  chooses
  958.                   #1.   You will  have a  DOORx.BAT file  for EACH  LiveCat
  959.                   menu  that  you  install  in  your  system,  but for this
  960.                   session we will  create ONLY the  one, DOOR1.BAT file  to
  961.                   start  LiveCat  with  your  WARGAMES  menu as the default
  962.                   menu.
  963.  
  964.            * IF YOU DON'T DO  ANYTHING ELSE RIGHT - YOU  MUST CREATE
  965.              THE DOORx.BAT  FILES CORRECTLY  OR LIVECAT  WILL SIMPLY
  966.              NOT RUN *
  967.  
  968.              Your DOOR1.BAT file will look EXACTLY like this:
  969.  
  970.              LIVECAT MONITOR.CFG WARGAMES
  971.              CD \WC30
  972.  
  973.              Each DOORx.BAT file you  create will be identical  to the
  974.              above WITH ONE  EXCEPTION.  The  menu name WARGAMES  will
  975.              be different  in DOOR2.BAT  thru DOORx.BAT.   These  MENU
  976.              NAMES correspond with  what you want  the user to  see as
  977.              the DEFAULT  LiveCat menu  when they  make a  door choice
  978.              while  in  Wildcat!.   You  might  for  example have your
  979.              system set  up so  that DOOR  1 in  Wildcat! is WAR GAMES
  980.              and DOOR 2 might contain  Adventure Games.  In this  case
  981.              DOOR1.BAT would be identical  to the above and  DOOR2.BAT
  982.              would be EXACTLY the same except that line 2 would say:
  983.  
  984.              LIVECAT  MONITOR.CFG  ADVENTUR  (provided  of  course you
  985.              named your second LiveCat menu ADVENTUR)
  986.  
  987.              One final note about the DOORx.BAT files.
  988.  
  989.              1.) All DOORx.BAT files are located in x:\WC30 directory.
  990.  
  991.        Initial installation of LiveCat 3.1 is now complete.  You will now
  992.        begin installing MENUS and DOORS into your LiveCat system.
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.        LiveCat Version 3.1             18                     06-09-91
  1000.  
  1001.        **** SPECIAL NOTE **** **** IMPORTANT *****
  1002.        In order for LiveCat to do all the things it is designed to do,  you
  1003.        MUST pay close attention to your use of security levels in  WILDCAT.
  1004.        It is recommended that you  only use the MINIMUM number  of security
  1005.        levels to properly secure your system.
  1006.  
  1007.        In a WILDCAT system,  the most important file  to LiveCat is a  file
  1008.        called 'MONITOR.DAT'. This file contains an entry for each  security
  1009.        level being  used in  your WILDCAT  system and  the total  amount of
  1010.        daily BBS time users with that security level can have.
  1011.  
  1012.        This file is read by LiveCat when a user enters doors for the  first
  1013.        time each day.   It looks up their  security level in this  file and
  1014.        then determines how much daily time  they can have, and how much  of
  1015.        that time  can be  used for  doors.   This time  is the  one against
  1016.        which all other LiveCat time calculations are performed.
  1017.  
  1018.        YOU SHOULD MAKE SURE THAT THERE IS AN ENTRY IN THE MONITOR.DAT
  1019.        FILE FOR EACH SECURITY LEVEL IN  USE ON YOUR SYSTEM..PLUS LEVEL
  1020.        110 EVEN IF YOU ARE NOT USING IT.
  1021.  
  1022.        If LiveCat   cannot find   a security   level in  the  MONITOR..DAT
  1023.        file that matches the one assigned   to the user that just   entered
  1024.        doors,  it  will   by  default   assign  security   level  10  and a
  1025.        maximum  daily  board  time  of  30   minutes.   It  will  use these
  1026.        numbers to  calculate the door control times.
  1027.  
  1028.         I  further  recommend  that  you  assign  to  yourself, as sysop, a
  1029.        security  level  of  1000  and  make  sure  it  is  entered  in  the
  1030.        MONITOR..DAT file with the proper time limits.  This makes it easier
  1031.        for LiveCat to  recognize you as  the sysop and  not control you  as
  1032.        tightly as a regular user.
  1033.  
  1034.         Please read the above descriptions completely until you  understand
  1035.        them.   The setup  of this  is crucial  to the  proper operation  of
  1036.        LiveCat.
  1037.  
  1038.         LiveCat is now configured to run on your system.  The next step  is
  1039.        to begin building  your LiveCat operating  menus.  These  menus will
  1040.        contain all of the doors available on your BBS.
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.        LiveCat Version 3.1             19                     06-09-91
  1064.  
  1065.         [[ CREATING NEW MENUS ]]
  1066.  
  1067.         The next step in  configuring LiveCat to run  on your system is  to
  1068.        build the  system menus  and install  the execution  script for each
  1069.        door in your system.
  1070.  
  1071.         The LsEdit editor  is designed to  make this as  easy and intuitive
  1072.        as possible, but  I'll warn you  now, it's going  to take some  time
  1073.        and work.
  1074.  
  1075.         Make sure you are logged into the \WC30\WCWORK\NODE1 directory If
  1076.        you are ready to start building just type: LSEDIT
  1077.  
  1078.          The intro screen of the  editor does a little salesmanship  for me
  1079.        and then  expects you  to press  <ENTER> to  get started.   When you
  1080.        press <ENTER> the main operating menu appears.
  1081.  
  1082.         Creating  a  menu  with  the  editor  is  a  single step, very fast
  1083.        process and  isn't difficult.   All you  need are  the names  of the
  1084.        menus you  decided on  earlier, and  remember that  you MUST install
  1085.        menus in the same order that  you created your DOORx.BAT files.   If
  1086.        DOOR1.BAT  is  for  the  WARGAMES  menus,  then you must install the
  1087.        WARGAMES menu first, then the name in your DOOR2.BAT and so on.
  1088.  
  1089.         Also remember that All of the  work in setting up LiveCat comes  at
  1090.        the front  end when  you are  installing all  of your existing doors
  1091.        for the first  time.  After  that, the installation  and maintenance
  1092.        of doors inside LiveCat is extremely fast and simple.
  1093.  
  1094.         * INSTALLING YOUR FIRST MENU *
  1095.  
  1096.         Step 1:  Make sure  you are in the \WC30\WCWORK\NODE1  directory,
  1097.                  where your MONITOR.CFG   is  located,   and  type:
  1098.                  LSEDIT   to get the editor started.
  1099.  
  1100.                   LsEdit  uses the  classic 'Pull  Down' menu  approach  to
  1101.                  present  informtion  and  choices  to  you.  All movements
  1102.                  through the menu structure are via the arrow keys OR  full
  1103.                  'Point and Shoot' mouse functions.
  1104.  
  1105.  
  1106.         Step 2:  The LsEdit  cursor highlight should be positioned  on MENU
  1107.                  FUNCTIONS  at  this  time.   Use  the  right  arrow key to
  1108.                  positon  the  highlight  on  MENU  FUNCTIONS and then Just
  1109.                  press   ENTER   and   the    pull   down   will    appear.
  1110.  
  1111.         Step 3:   Use the down  arrow key to  move to: CREATE  NEW MENU and
  1112.                  press ENTER.   The menu  display box  should open  and the
  1113.                  cursor  will  be  placed  in  the entry field awaiting the
  1114.                  entry of your first menu name.
  1115.  
  1116.         Step  4:   Enter  the  name  of  your  first  menu and press ENTER.
  1117.                  Remember that  the menu  name you  enter here  is the SAME
  1118.                  menu name  you selected  in   the previous  steps and  put
  1119.                  into each of the DOOR1.BAT files as a menu name.
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.        LiveCat Version 3.1             20                     06-09-91
  1128.  
  1129.  
  1130.                 Remember also that menu names MUST follow all the rules  of
  1131.                 a DOS file  name.  They  must contain standard  characters,
  1132.                 no spaces and they must be 8 or less characters in  length.
  1133.                 The name you  chose for the  menu will be  displayed to the
  1134.                 user while in  LiveCat so the  names should be  meaningful.
  1135.                 We are going  to build the  menu for our  WARGAMES category
  1136.                 and we  are going  to install  two doors  in it, Trade Wars
  1137.                 500 and Power Struggle.
  1138.  
  1139.                 Type in WARGAMES now and press <ENTER>.
  1140.  
  1141.         Step 5:  When you  pressed ENTER  the cursor  moved to the SECURITY
  1142.                 and is  waiting for  input.   The number  you place in this
  1143.                 field is the LOWEST security  in your system that you  will
  1144.                 allow  to  view  this  menu.   If  you  don't  want  to use
  1145.                 security  on  your  menus,  just  enter  the  number of the
  1146.                 lowest level available on your system and the menu will  be
  1147.                 open  to  all  users  above  that  level. Enter the desired
  1148.                 security level for this menu now.
  1149.  
  1150.         Step 6: Reselect the ADD MENU function and install any other  menus
  1151.                 that you would like to use at this time.
  1152.  
  1153.         This  completes  installation  of  a  MENU into the MONITOR system.
  1154.        Thats all there  is to it.   ANYTIME you wish  to add a  new menu to
  1155.        your system this is the series  of steps you will  follow.  You  may
  1156.        install as many menus as you want, up to 64 and as long as no  doors
  1157.        are physically attached to them, the menus will not display.
  1158.  
  1159.         Now comes the FUN part,  actually installing DOORS into your  newly
  1160.        created menus.
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.        LiveCat Version 3.1             21                     06-09-91
  1192.  
  1193.         [[ INSTALLING DOORS INTO THE MENU SYSTEM ]]
  1194.  
  1195.          If  there  is  a  _HARD_  part  to installing LiveCat, this is it.
  1196.        Installing a door is  NOT difficult, IF you  have some idea of  what
  1197.        you  are  doing  with  doors  in  general.   If  this  is your first
  1198.        experience with doors,  then things will  be a little  tougher, BUT,
  1199.        persistance WILL pay off and LiveCat will run your door system  like
  1200.        no other product on the market.
  1201.  
  1202.         The series  of steps  presented below  will lead  you step  by step
  1203.        through  the  installation  of  the  Trade  Wars  500 door into your
  1204.        WARGAMES menu  created previously.   The version  of Trade  Wars  we
  1205.        will  be  using  is  release  10.0.   Use  of any other version will
  1206.        likely be somewhat different.
  1207.  
  1208.         Step 1:   The first step of course is to create a directory on your
  1209.                   system to hold the Trade Wars programs and data.  Do that
  1210.                   now.  Unzip your Trade Wars files into this new directory
  1211.                   now.
  1212.  
  1213.         Step 2:  Change to your x:\WC30\WCWORK\NODE1 directory and start
  1214.                  up the editor by typing: LSEDIT
  1215.  
  1216.         Step 3:  The menu select  bar is already  on EDIT SCRIPTS  so just
  1217.                  press to get the pull down menu of functions.
  1218.  
  1219.         Step 4:  Move the select bar to ADD NEW DOOR and press <ENTER>
  1220.  
  1221.         Step 5:  In LiveCat 3.1 EACH and EVERY door MUST be given a  UNIQUE
  1222.                  identifying  name.   This  name  is  how  LiveCat   itself
  1223.                  selects and runs the user specified door.  It is ALSO  how
  1224.                  YOU select doors later on for editing and changes.
  1225.  
  1226.                  At this time the editor is asking for the NAME of the  new
  1227.                  door you will be installing.  This name is NOT related  to
  1228.                  the  MENU  names  that  you  created  earlier, but it DOES
  1229.                  follow the same  convention, 8 characters  or less and  no
  1230.                  spaces in the  name.  For  our Trade Wars  door a name  of
  1231.                  TW500 sounds good so enter that now and press ENTER.
  1232.  
  1233.         Step 6:  As soon as you  pressed ENTER in the step above, the  DOOR
  1234.                  ATTRIBUTES window  opens and  it's expecting  some entries
  1235.                  that will tell it all  about what YOU want to  happen when
  1236.                  the door is run.   On the next page  is a graphic of  what
  1237.                  you should be seeing.
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.  
  1252.  
  1253.  
  1254.  
  1255.        LiveCat Version 3.1             22                     06-09-91
  1256.  
  1257.                                                 ╔════════════════02:39:50╗
  1258.          Menu Functions  Text Editor   Print  Op║  A = 2-AM              
  1259.        ═══════════╗░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║  B = Unused            ║░
  1260.        or Script  ║░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║  C = GTPower Comm      ║░
  1261.        ═════════════════════════════════════════║  D = Door.sys Generic  ║░
  1262.                                                 ║  E = Unused            ║░
  1263.           Door Type (Q/G/R/P/W/2/4) = 4         ║  F = Unused            ║░
  1264.                          Door NAME  = TW500     ║  G = GAP 4.x/5.x       ║░
  1265.                    Attached to Menu = WARGAMES  ║  H = Unused            ║░
  1266.           Door Time limit (minutes) = 30        ║  I = Unused            ║░
  1267.                  Low Security Limit = 20        ║  J = Unused            ║░
  1268.                 High Security Limit = 1000      ║  K = Unused            ║░
  1269.        One run lock (Y/N) or (2..9) = N         ║  L = Unused            ║░
  1270.            Menu Display Discription = Trade Wars║  M = Unused            ║░
  1271.         Unlock DTE before run (Y/N) = Y         ║  N = Unused            ║░
  1272.                   Door LOCKED (Y/N) = N         ║  O = Unused            ║░
  1273.               Multi User Door (Y/N) = N         ║  P = PCBoard 12.x      ║░
  1274.                         Door Number = 0         ║  Q = QBBS              ║░
  1275.                       Date Last Run = 10/28/90  ║  R = RBBS 15.1C+       ║░
  1276.                                                 ║  S = Spitfire 2.7+     ║░
  1277.        ═════════════════════════════════════════║  W = Wildcat 1.10/.11  ║░
  1278.        ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║  2 = Wildcat 1.12/.13  ║░
  1279.        ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║  3 = Wildcat 2.xx      ║░
  1280.        ░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░║  4 = PCBoard 14.x      ░
  1281.                                                 ╚════════════════════════╝
  1282.  
  1283.         Step 7:   The first field  you are being  prompted for is  the DOOR
  1284.                  TYPE. Door Type   means 'WHAT  BBS  SYSTEM  WAS THIS  DOOR
  1285.                  DESIGNED TO  BE RUN   ON'. The  door type  code you  enter
  1286.                  here is  very important.   If it's  not correct,  the door
  1287.                  will absolutely  refuse to  function properly,  if at all.
  1288.                  You  may  refer  to  appendix   C  for  a  more   detailed
  1289.                  explaination of the  meaning  of each of Door Type   Codes
  1290.                  available.  We  will be  running our Trade Wars  500  door
  1291.                  on the Wildcat 1.12/1.13  interface so move the   selector
  1292.                  bar in the pick list to  the 2 type door for Wc  1.12/1.13
  1293.                  and press  ENTER. The  door type  code is  moved into  the
  1294.                  proper   field in  the attributes.   It   may   take  some
  1295.                  experimentation with new doors to determine exactly  which
  1296.                  of the available  interface types are  required for it  to
  1297.                  function properly.
  1298.  
  1299.  
  1300.          Step 8: Attaching the DOOR to a MENU.  The next field called  MENU
  1301.                  ATTACHMENT is driven by a  pick list.  You will  note that
  1302.                  this  pick  list  contains  the  names  of  the  menus you
  1303.                  previously installed  with LSEDIT.   You may  move up  and
  1304.                  down through  the pick  list by  use of  your up  and down
  1305.                  arrow keys, or your mouse.   Position the selector bar  in
  1306.                  the pick list on the  menu name WARGAMES and press  ENTER.
  1307.                  You will note  that the menu  name is moved  into the MENU
  1308.                  ATTACHMENT  field  of  the  attributes.   You can move ANY
  1309.                  door to ANY menu instantly by just calling up this  window
  1310.                  and  selecting  a  different  menu  from  the  pick  list.
  1311.                  Lsedit will  instantly remove  the door  from the original
  1312.                  menu and place it in the new one.
  1313.  
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319.        LiveCat Version 3.1             23                     06-09-91
  1320.  
  1321.          Step 9: The next field is the time limit you will place on each
  1322.                  run of this  door.  LiveCat  will enforce this  time limit
  1323.                  and NOT  allow the  user to  stay inside  the door  longer
  1324.                  than this amount of time.  For Trade Wars I usually  allow
  1325.                  about 40 minutes maximum play time so enter the number  40
  1326.                  here.
  1327.  
  1328.          Step 10: You are now being asked to supply the LOW LEVEL  security
  1329.                   for  this  door.   LiveCat  allows  doors  to  be tightly
  1330.                   controlled by the users  security level.  The  number you
  1331.                   enter  here  is  the  security  level of the LOWEST level
  1332.                   user  you  will  allow  to  use  this  door.  If you wish
  1333.                   EVERYONE to be able to use this door then just enter  the
  1334.                   number  of  the  lowest  security  level  in  use on your
  1335.                   system in this field.
  1336.  
  1337.          Step 11: The HIGH security  level field is exactly like  the field
  1338.                   above.  It determines  the security level of  the HIGHEST
  1339.                   level user you will allow to use this door.  If you  want
  1340.                   EVERYONE to  be able  to use  the door,  enter your SYSOP
  1341.                   security level in this field.
  1342.                   Through  creative  use  of  the  two above fields you can
  1343.                   restrict the running of  certain doors from a  wide range
  1344.                   of levels down to a single permitted level.  By  entering
  1345.                   the  number  50  in  both  fields for instance, you would
  1346.                   restrict  the  door  to  being  run  ONLY  by  users with
  1347.                   security level 50,  PLUS of course  YOU as the  sysop can
  1348.                   run  it   because  you   are  exempt   from  all    these
  1349.                   restrictions.
  1350.  
  1351.          Step 12:  Entering RUN  CODES.   The field  you are being prompted
  1352.                   for  now  can  be  a  bit  confusing  since it allows two
  1353.                   different  types  of  entries.   Some  doors you may want
  1354.                   restricted to only  a single run  per day, if  that's the
  1355.                   case enter a Y in this field, meaning RUN ONCE ONLY.   If
  1356.                   you want  NO limits  on the  number of  times each  day a
  1357.                   door can  be run,  enter N.   Additionally you  may enter
  1358.                   any  NUMBER  between  2  and  9  and  the  door  will  be
  1359.                   restricted to that many runs on any day.
  1360.  
  1361.            Examples are:  Y  Allow 1 run per day only.
  1362.                           N  Allow unlimited runs daily
  1363.                           3  Allow only 3 runs per day
  1364.  
  1365.          Step  13:  Menu  Item  Description:   This  line  permits up to 25
  1366.                   characters to be entered  for a MENU DESCRIPTION.   These
  1367.                   one line descriptions are displayed to the user while  in
  1368.                   LiveCat  so  they  should  be  as descriptive as possible
  1369.                   within the  one line  allowed.   The description  for our
  1370.                   Trade Wars door might look like this:
  1371.  
  1372.                   Trade Wars 500 My favorite
  1373.  
  1374.                   This will appear to the  user when they see the  WARGAMES
  1375.                   menu as  : [A]  .. Trade  Wars 500  My Favorite, and they
  1376.                   would press the letter A to run it.
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.        LiveCat Version 3.1             24                     06-09-91
  1384.  
  1385.         Step 14:   Unlock  DTE  (Y/N): This is   a very special  field  and
  1386.                   can  be  confusing  if   you  do  not  understand what is
  1387.                   meant  by  'Locked   DTE'.     It   won't   be  important
  1388.                   unless you are running a high speed modem  whose  comport
  1389.                   is locked at  a baud   rate  of  19200   or  38400.    If
  1390.                   you  use  one  these  modems    then   you   MUST    read
  1391.                   appendix  C  carefully that talks  about variations   and
  1392.                   problems you  will encounter.  In the case of Trade  Wars
  1393.                   500 it will run just fine   with the DTE locked at  19200
  1394.                   and any rate  below that. It   will NOT run  on  a  modem
  1395.                   whose   baud rate  is   locked at  38400.   If you have a
  1396.                   modem locked at 19200  OR  a modem that  is NOT   locked,
  1397.                   a  standard   2400  modem   or anything else, enter  N in
  1398.                   this  field.   This says:    'No, do NOT   unlock the DTE
  1399.                   before   running  the  door'.     If  you  have   a modem
  1400.                   attached  whose  baud  rate  is  locked  at  38400,  then
  1401.                   answer with  a   Y  that   says:   'Yes,   DO unlock  the
  1402.                   DTE before running this door.
  1403.  
  1404.         Step 15:  DOOR LOCKED (Y/N):
  1405.                  This is an important field  in a Multi-User system.   Each
  1406.                  time LiveCat runs a door, this field is set BY LIVECAT  to
  1407.                  a Y  to indicate  that door  is IN  USE and  LOCKED OUT to
  1408.                  other nodes!  YOU may use this field to manually lock  out
  1409.                  a door while  you are testing  the door or  to repair it!.
  1410.                  Simply  set  this  flag  to  Y  and  the  door will become
  1411.                  inaccessible to other users.
  1412.  
  1413.                  *NOTE* If for some  reason your system should  CRASH while
  1414.                  a door is  running, LiveCat will  NOT get a  chance to set
  1415.                  this flag back to N to clear the lock on it.  You must  do
  1416.                  that  manually  by  calling  up  the edit door function in
  1417.                  LsEdit and manually  changing this flag  back to N.   This
  1418.                  will manifest  itself to  users by  telling them  that the
  1419.                  door IS IN USE ON ANOTHER NODE when the door is not  being
  1420.                  run at  all!   This will  ONLY happen  if your system goes
  1421.                  down  and  LiveCat  does  NOT  get  a  chance to reset the
  1422.                  LOCKED flag back to 'N'.
  1423.  
  1424.         Step 16:  Multi-User Door (Y/N):
  1425.                   This  is  also  a  very  important  field in a multi-user
  1426.                   system.   Some  doors  DO  permit  more  than one user to
  1427.                   execute them  at any  given time.   If this  is true with
  1428.                   the  door  you  are  installing,  set  this flag to Y and
  1429.                   LiveCat will let all  users into the door  simulateously.
  1430.                   This can have DISASTROUS  effects on a SINGLE  USER DOOR!
  1431.                   Take  care,  if  you  don't  know  for  SURE if a door is
  1432.                   single user or multi-user, set this to N to mark it as  a
  1433.                   single user door.  Don't take chances with this.
  1434.  
  1435.        You will have noticed  that there are 2  or 3 fields in  the window
  1436.        that you are NOT allowed to edit.  Door name is one of them.
  1437.  
  1438.         Remember that  you are  NOT allowed  to CHANGE  the DOOR  NAME of a
  1439.        door once  it's installed  into the  system because  of the  indexed
  1440.        nature of the database.  If you  wish to CHANGE the NAME OF A  DOOR,
  1441.        you must first DELETE the door entirely and then ADD it again  under
  1442.        the new name.
  1443.  
  1444.  
  1445.  
  1446.  
  1447.        LiveCat Version 3.1             25                     06-09-91
  1448.  
  1449.         The other fields you  are not allowed to  edit are fields that  are
  1450.        maintained automatically by LiveCat, door number is used to  control
  1451.        the daily multiple  run parameters, and  Date Last Run  is there for
  1452.        you to see  when the door  was last run.   This field will  help you
  1453.        evaluate and get rid of those doors that are not being run and  just
  1454.        taking up disk space.
  1455.  
  1456.  
  1457.         Now!!! We move to  the MOST critical part  of installing a door  in
  1458.        the LiveCat environment, writing the 'Execution Script'
  1459.  
  1460.         ** EXPLANATION OF SCRIPTS **
  1461.  
  1462.         In loose terms  an EXECUTION SCRIPT   is similar to  a batch  file.
  1463.        It is the sequence of commands that LiveCat will follow each time  a
  1464.        user runs the door.   Entering an execution script  is very easy  to
  1465.        do if you have all of the info about the door.
  1466.  
  1467.         While in the script editor, you  have all most all the features  of
  1468.        a good  text editor  available to  you, including  line delete, line
  1469.        insert, block moving  and so on.   While inside the  editor, the  F1
  1470.        key  is  the  help  key  and  will  display  all  of editor commands
  1471.        available, use it!   I will not  cover function by  function use  of
  1472.        the editor.
  1473.  
  1474.         * YOU CANT *
  1475.         Even though a SCRIPT has  many similarities to a BATCH  FILE, there
  1476.        are a  number of  BATCH language  commands you  may NOT  use in  the
  1477.        script.
  1478.  
  1479.         You CAN use GOTO's, CALL, IF EXIST and most all DOS level  commands
  1480.        but  you  CANNOT  use  IF  ERRORLEVEL  and  you  may  NOT use the %x
  1481.        modifiers to try to pass  parameters.  In a LiveCat  environment the
  1482.        normal parameters passed to  a batch file in  the %1 %2 etc.  manner
  1483.        have no meaning.
  1484.  
  1485.          * IMPORTANT *
  1486.         There are a number  of cases in which  your SCRIPT file might  need
  1487.        to  execute  BATCH  FILES.   If  this  is  the  case, you must NEVER
  1488.        execute the  required batch  file by  simply typing  it's name  on a
  1489.        line of the script.
  1490.  
  1491.         To execute a BATCH FILE from within a LiveCat script, you MUST  use
  1492.        DOS 3.3 CALL  command to execute  the batch, OR  use the EXECUTE.EXE
  1493.        program supplied  with LiveCat  to handle  it.   If you  DO NOT call
  1494.        batch files in the  following manner, LiveCat will  completely loose
  1495.        track of the door it is  trying to execute and the reaction  will be
  1496.        unpredictable.
  1497.  
  1498.               Example script calling of batch files:
  1499.  
  1500.                 CD \DOOR
  1501.                 CALL PREPARE.BAT
  1502.                 DOOR DOOR.CFG
  1503.                 CD \WILDCAT
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.        LiveCat Version 3.1             26                     06-09-91
  1512.  
  1513.              or
  1514.                 CD \DOOR
  1515.                 EXECUTE PREPARE.BAT
  1516.                 DOOR DOOR.CFG
  1517.                 CD \WILDCAT
  1518.  
  1519.           PREPARE.BAT is a normal batch file, the only thing it CANNOT do
  1520.           is receive %1 %2 %x.... parameters from the script.
  1521.  
  1522.          As a general rule, enter only the bare minimum commands to  change
  1523.        to the directory where the door is at and execute it.  LiveCat  will
  1524.        automatically change itself  back to the  proper directory when  the
  1525.        door has shut down. There is  no need to put commands in  the script
  1526.        to CD back to the LiveCat directory itself.
  1527.  
  1528.         ** ENTERING THE SCRIPT FOR TRADE WARS 500 **
  1529.  
  1530.         Organizationally, each door on your system should have it's own
  1531.        subdirectory.  The complete path to TW on my system is:
  1532.          C:\DOORS\TW500
  1533.  
  1534.         Remember that and try to visualize the paths as we create the
  1535.        script.
  1536.  
  1537.         The script  on MY  system would  like this,  you just  change it to
  1538.        suit your path names.
  1539.  
  1540.           cd \doors\tw500
  1541.           tw2 /P %D\%I\CALLINFO.BBS
  1542.  
  1543.          That's it!!  Notice  that I did NOT  include a command to  restart
  1544.        WILDCAT such as  'cat.bat' or a  command to restart  LiveCat. That's
  1545.        because all  restarting is  handled by  the DOORX.BAT  file that you
  1546.        created.  You must NEVER include a command to restart Wildcat!  from
  1547.        within a door script, the result will be a mess!
  1548.  
  1549.          Now, here is a script for a PCBoard 12.x door that is typical of
  1550.        the installation and running of that type of door on a multi-node
  1551.        system.
  1552.  
  1553.           CD \DOORS\GUPPIES
  1554.           GUP-%N.CFG
  1555.  
  1556.              A PCBoard 14.x example of the same door,
  1557.  
  1558.              SET DOORPCH=PCB
  1559.              CD \DOORS\GUPPIES
  1560.              GUPPIES GUP-%N.CFG
  1561.  
  1562.         Again, in both cases, very simple.  The command line to start  Card
  1563.        Guppies, GUPPIES GUP-%N.CFG includes  the name of the  configuration
  1564.        file (.CFG) that  the door should  read during startup  that informs
  1565.        it WHERE the PCBOARD.SYS file is that it needs to run.
  1566.  
  1567.  
  1568.  
  1569.  
  1570.  
  1571.  
  1572.  
  1573.  
  1574.  
  1575.        LiveCat Version 3.1             27                     06-09-91
  1576.  
  1577.         Now  some  explaination  is  order.   You  will have noticed in the
  1578.        example  TW500  and  GUPPIES  scripts  above  that  some  REPLACABLE
  1579.        parameters  were  used  that  begin  with  the  character % (percent
  1580.        sign).
  1581.  
  1582.         LiveCat  3.1  incorporates  a  new  Script  Parameter Language that
  1583.        allows special directives to be imbedded in your script and will  be
  1584.        used by some doors to receive specialized commands on their  command
  1585.        line.  The Script  language is also used  by and is critical  to the
  1586.        operation  of  Multi-User  versions  of  LiveCat running on multiple
  1587.        node Wildcat! systems.
  1588.  
  1589.         These  replacable  parameters  are  designed  to  replace the %1 %2
  1590.        parameter  passing  functions  in  a  batch  file.  They are able to
  1591.        modify  the  door  command  line  at  run  time to take some special
  1592.        action that otherwise would not be possible.
  1593.  
  1594.        Refer to  Appendix E  for all  the replacable  parameters available,
  1595.        and their use.
  1596.  
  1597.         In a  MULTI-NODE LiveCat  system, you  MUST remember  that the SAME
  1598.        SCRIPT runs doors for ALL NODES!
  1599.  
  1600.         The example TRADE  WARS script is  fairly unique and  shows you how
  1601.        these parameters  work with  some doors  that do  NOT depend on .CFG
  1602.        files to obtain callers information.
  1603.  
  1604.        Trade  Wars  500  Version  10.0,  which  is  what  we  are presently
  1605.        installing, does  NOT use  a .CFG  file as  do most  other types  of
  1606.        doors.  Instead, it picks up the location of the CALLINFO.BBS to  be
  1607.        read from the command line.
  1608.  
  1609.        The replacable parameters  in the example  TW500 script tell  it how
  1610.        to do this.  The command line in the script actually reads:
  1611.  
  1612.        TW2 /P %D\%I\CALLINFO.BBS
  1613.  
  1614.        At runtime, LiveCat constructs the runtime file to read:
  1615.  
  1616.        TW2 /P C:\WC30\WCWORK\NODE1\CALLINFO.BBS
  1617.  
  1618.        This is true of  course if the script  were actually being run  from
  1619.        NODE 1.   If it  was being  run from  NODE 2,  then at  runtime  the
  1620.        script contstructed by LiveCat would read:
  1621.  
  1622.        TW2 /P C:\WC30\WCWORK\NODE2\CALLINFO.BBS
  1623.  
  1624.        Both runtime files  were created by  LiveCat based on  the NODE from
  1625.        which the door is currently being executed.
  1626.  
  1627.        The replacable parameters used are:
  1628.  
  1629.        %D means replace this with the DRIVE LETTER that is the current
  1630.           drive, or in this case, C:
  1631.  
  1632.        %I means replace this with the name of the CURRENT NODE HOME
  1633.           DIRECTORY.
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.        LiveCat Version 3.1             28                     06-09-91
  1640.  
  1641.        See how that  works?  It  may take you  a little head  scratching to
  1642.        figure this out, but once you  understand how it works, it can  save
  1643.        you tremendous amounts  of time when  configuring a new  door to run
  1644.        on your multi-node system since the script need only be put in  ONCE
  1645.        and all menu changes are automatically taken care of.
  1646.  
  1647.        In the GUPPIES  scripts the %N  replacable parameter is  replaced at
  1648.        runtime by LiveCat to read: GUPPIES GUP-1.CFG.
  1649.  
  1650.         If you were running  a 3 node Wildcat!  system, you must of  course
  1651.        have a .CFG for GUPPIES to read from EACH NODE!  Or, a GUP-1.CFG,  a
  1652.        GUP-2.CFG and a GUP-3.CFG.
  1653.  
  1654.         This is necessary  because the .CFG  files for the  doors MUST look
  1655.        in  DIFFERENT  NODE  directories  to  find  the PCBOARD.SYS and .DAT
  1656.        files, therefore you must be able to tell GUPPIES at runtime,  WHICH
  1657.        .CFG file  to use  so that  the proper  .CFG will  be read.   The %N
  1658.        parameter is  ALWAYS replaced  by LIVECAT  with NODE  NUMBER of  the
  1659.        node that is actually executing this script at any given time.   The
  1660.        NODE  NUMBER  will  always  be  placed  in  the  EXACT locatation at
  1661.        runtime that the %N parameter appears.
  1662.  
  1663.        For  example,  using  the  above  script  with  the %N parameter, at
  1664.        runtime from NODE 1, LiveCat  would contstruct a runtime batch  file
  1665.        to exectute guppies that would read:
  1666.  
  1667.         CD \DOORS\GUPPIES
  1668.         GUPPIES GUP-1.CFG
  1669.  
  1670.        or, if run from node 2, the file would read:
  1671.  
  1672.         CD \DOORS\GUPPIES
  1673.         GUPPIES GUP-2.CFG
  1674.  
  1675.         IN  ALL  cases  you  MUST  NOT  run  other  types  of  file  format
  1676.        converters such as WC2GAP or GAPDOOR to convert from one board  type
  1677.        to another unless you are  specifically instructed to do so  by this
  1678.        documentation because LiveCat does all  that for you and if  you try
  1679.        to  include  these  other  conversion  utilities  in your script you
  1680.        DEFEAT LiveCat's attempt to time control the door.
  1681.  
  1682.        Believe it or not!, Trade Wars has now been installed in LiveCat.
  1683.  
  1684.         And  thats  all  there  is  to  it!   Each  and every door that you
  1685.        install  in  your  system  will  be  installed  in  EXACTLY the same
  1686.        manner.   The only  things that  will vary  are the  content of  the
  1687.        script to actually run the door.
  1688.  
  1689.         It may seem a bit confusing the  first time or two that you do  it,
  1690.        but as soon  as you get  used to the  procedure, and get  some doors
  1691.        experience under your belt, you  will find that the editor  makes it
  1692.        very easy and fast to install  a new door, edit an existing  one and
  1693.        to diagnose a problem with any door in your system.
  1694.  
  1695.  
  1696.  
  1697.  
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.        LiveCat Version 3.1             29                     06-09-91
  1704.  
  1705.         [[ EDITING EXISTING DOORS ]]
  1706.  
  1707.         It is necessary from  time to time to  edit menus that are  already
  1708.        in your system.  This is how you would move a door from one menu  to
  1709.        another menu or alter some aspect  of a door that is already  in the
  1710.        system.  You might want to change the time users have for the  door,
  1711.        it's required security or possibly change the re-run lock flags.
  1712.  
  1713.         ** SELECTING A DOOR TO EDIT **
  1714.  
  1715.         To edit an existing menu you first need to SELECT it.  You do  this
  1716.        almost as  if you  were entering  a new  door, by  pulling down  the
  1717.        SCRIPT EDITING window at  the main menu.   Move the selector bar  to
  1718.        SCRIPT EDITING and press ENTER to pull it down.
  1719.  
  1720.         When the  SCRIPT EDITING  Pull Down  appears, you  will notice that
  1721.        one of the seletions is EDIT EXISITING DOOR.  Move the selector  bar
  1722.        to this item and press ENTER.
  1723.  
  1724.         A  pick  list  opens  at  this  point  that  contains  the name and
  1725.        description of each  and every door  in your system  in alphabetical
  1726.        order by door name.
  1727.  
  1728.         You move  up and  down in  the pick  list window  with up  and down
  1729.        arrows and the page  up and page down  keys, OR by positioning  your
  1730.        mouse cursor on  the arrows in  the left side  of the window  border
  1731.        and pressing the left mouse button.
  1732.  
  1733.         Postion the selector  bar over the  door you wish  to view or  edit
  1734.        and  either  press  ENTER  or  the  left  mouse  button and the door
  1735.        attributes  window  will  appear  and  you're  on your way.  You can
  1736.        change ALMOST  every aspect  of the  door at  this time  except it's
  1737.        name.
  1738.  
  1739.  
  1740.  
  1741.  
  1742.  
  1743.  
  1744.  
  1745.  
  1746.  
  1747.  
  1748.  
  1749.  
  1750.  
  1751.  
  1752.  
  1753.  
  1754.  
  1755.  
  1756.  
  1757.  
  1758.  
  1759.  
  1760.  
  1761.  
  1762.  
  1763.  
  1764.  
  1765.  
  1766.  
  1767.        LiveCat Version 3.1             30                     06-09-91
  1768.  
  1769.        [[ APPENDIX A - FIELDS IN LSCONFIG ]]
  1770.  
  1771.         Read this  appendix carefully!   Most of  the parameters  you enter
  1772.        here are CRITICAL to the proper operation of LiveCat and your BBS.
  1773.  
  1774.         Experience  has  taught  me  over  the  years  that 99% of reported
  1775.        problems  with  LiveCat  can  be  traced  to  improper configuration
  1776.        and/or and incomplete understanding  of exactly what each  parameter
  1777.        in the configuration  file controls.   Understand VERY clearly  that
  1778.        the MONITOR.CFG file that contains this information is produced  and
  1779.        maintained by LsEdit and you must NEVER edit the MONITOR.CFG with  a
  1780.        text  editor  or  you  will  destroy  it  AND  possibly  your  doors
  1781.        database!
  1782.  
  1783.          FIELD 1: Name of This BBS:
  1784.            Self explanitory.  Enter the name of your BBS as you wish
  1785.            it to appear to callers.
  1786.  
  1787.          FILED 2: Sysop FIrst Name:
  1788.            YOUR first name.
  1789.  
  1790.          FIELD 3: Sysop Last Name:
  1791.            YOUR last name.
  1792.  
  1793.          FIELD 4: Home Directory for this node.
  1794.            The full name of the directory which is considered to be the
  1795.            base directory for the node.  Ie: \WC30\WCWORK\NODE1 would be
  1796.            entered as the Home directory for NODE 1. It is critical that
  1797.            this field be correct.
  1798.  
  1799.          FIELD 5: Path to the ACTIVITY LOG for this node:
  1800.            This is the FULL PATH NAME INCLUDING THE ACTUAL NAME OF
  1801.            THE ACTIVITY.LOG.  An example is: C:\WC30\ACTIVITY.001.
  1802.            If you do NOT include the actual  name of the activity log, you
  1803.            will see Null Pointer assignment errors at the time LiveCat is
  1804.            trying to run a door.
  1805.  
  1806.          FIELD 6: Path to the MONITOR Data files:
  1807.            This extrememly important path name is what tells LiveCat
  1808.            WHERE it's files are located.  This is normally the
  1809.            LIVECAT directory and is normally one directory down from
  1810.            the \WC30 directory.  An example is C:\WC30\LIVECAT
  1811.            The directory named here is where the ATTRIB.DAT,
  1812.            ATTRIB.IDX, SCRIPT.DAT and SCRIPT.IDX files will be
  1813.            created by LSEDIT on first time startup and is where
  1814.            LIVECAT will look for the files.
  1815.  
  1816.          FIELD 7: FULL path to the BBS USERS file:
  1817.            This SHOULD be the FULL path and FILE NAME of your WILDCAT
  1818.            users file.  Although, in LIVECAT this field is not used
  1819.            at this time and whatever you enter here will be ignored,
  1820.            you should put it in because some future enhancement to
  1821.            LiveCat might require it.
  1822.  
  1823.          FIELD 8: Comport this node runs on (1..8):
  1824.            This is just the NUMBER only of the comport your system is
  1825.            running on.
  1826.  
  1827.  
  1828.  
  1829.  
  1830.  
  1831.        LiveCat Version 3.1             31                     06-09-91
  1832.  
  1833.          FIELD 9: Base Address:
  1834.            This field MUST be entered in conjunction with field 8.
  1835.            It is the base i/o address that the previously named
  1836.            comport is using.  In COM1 and COM2 systems LiveCat
  1837.            defaults this to 03F8 and 02F8.  If you are using a
  1838.            comport other than 1 or 2, you must determine the address
  1839.            at which the port is running. If you enter a number in
  1840.            this field, it MUST be in hexidecimal format at shown
  1841.            above.
  1842.  
  1843.          FIELD 10: IRQ:
  1844.             This is the INTERRUPT number your comport is using.  In
  1845.             COM1 and COM2 systems LiveCat defaults this number to 4
  1846.             and 3 respectively.  If you are running other than COM1
  1847.             or COM2, you must insert the appropriate IRQ number that
  1848.             your comport is using in this field.
  1849.  
  1850.          FIELD 11: Rate at which to LOCK MODEM DTE (NONE, 1200..38400):
  1851.             LiveCat has full support of high speed modems running at
  1852.             rates higher than 9600 baud, all the way to 57600 baud.
  1853.             If you do NOT have a high speed modem whose DTE is locked
  1854.             at some given rate, enter NONE in this field.  If you ARE
  1855.             using a high speed modem, and DO have the DTE locked,
  1856.             enter the RATE at which the DTE is locked in this field.
  1857.             If you are using a high speed modem whose DTE is NOT
  1858.             locked, then enter NONE.  If you are using a LOW speed
  1859.             MNP modem and DO have the DTE locked, enter the RATE at
  1860.             which the DTE is locked.
  1861.             Any lock rate from 1200 to 38400 baud is supported.
  1862.  
  1863.         FIELD 12:  Node NUMBER for this copy (1..99) ?
  1864.             Just place the NODE NUMBER for this node in this field. The
  1865.             range of numbers you can place here depend on the version you
  1866.             purchased.
  1867.  
  1868.         FIELD 13: LiveCat 3.1 has a built in ability to log the user off
  1869.             from within LiveCat.  This feature is optional.
  1870.             Be aware that if you ENABLE this feature by putting Y in
  1871.             the field the user will be shown a [BYE] option in the
  1872.             LiveCat main menu.  If the user type BYE at the LiveCat
  1873.             command line, the system drops DTR and hangs up.  This IS
  1874.             SEEN BY WILDCAT AS A CARRIER DROP AND IS RECORDED IN THE
  1875.             ACTIVITY LOG AS SUCH!  LiveCat does however clean up all
  1876.             it's files and the system exit is a normal one.  We do
  1877.             NOT interface directly to the Wildcat! user file and log
  1878.             the user off in a the same manner as Wildcat!
  1879.             If you do NOT want to enable this feature, put N in the
  1880.             field.
  1881.  
  1882.          FIELD 14: Do you want to use the optional SCORE BULLETIN System:
  1883.             LiveCat 3.1 has a built in Bulletin system similar to the
  1884.             main board bulletins.  It's purpose is to provide a place
  1885.             INSIDE LiveCat to display score bulletins from your
  1886.             doors as an alternative to displaying them in the main
  1887.             board bulletins.  This feature is optional.  Enable it by
  1888.             putting Y in the field.  If ENABLE this feature, you must
  1889.             create a new directory, 1 directory BELOW your LIVECAT
  1890.  
  1891.  
  1892.  
  1893.  
  1894.  
  1895.        LiveCat Version 3.1             32                     06-09-91
  1896.  
  1897.             directory, create a directory named BULL.  The full path
  1898.             name would be as follows: C:\WC30\LIVECAT\BULL.
  1899.             This directory is where you will direct your doors to
  1900.             place their scoring bulletins, according to the naming
  1901.             conventions documented in the installation steps, you
  1902.             must also place at least a BLT.BBS file in this directory
  1903.             that is a menu of the bulletins kept here.  Refer to the
  1904.             installation steps for naming conventions.
  1905.  
  1906.          FIELD 15: LiveCat will allow you to control door access based on
  1907.             the users upload/download ratio.  If you want to use the
  1908.             feature, enter the RATIO in this field.  An entry of 40
  1909.             for instance would enforce a ratio of 40:1 and if the
  1910.             user is outside that ratio they will not be allowed to
  1911.             enter the doors.  If you do NOT want to enforce ration,
  1912.             simply enter 0 (zero) in this field and it will be
  1913.             disabled.
  1914.  
  1915.          FIELD 16: What time do you want LOCK the door system (xx:xx):
  1916.             You may TOTALLY lock access to the doors system at
  1917.             a certain time of day.  Enter the time, in 24 hour format
  1918.             that you want the lock to BEGIN.  An entry of 23:00 for
  1919.             instance will lock the door system beginning at 11:00pm.
  1920.             If you do NOT want to lock the doors, enter 00:00.
  1921.             Notice that if you enter 00:00, the feature is DISABLE!
  1922.             You may NOT lock the door system ACROSS midnight, only on
  1923.             either side of it!
  1924.  
  1925.          FIELD 17: What time do you want to UNLOCK the door system (xx:xx):
  1926.             If you ENABLE locking in the field above, enter the time, in
  1927.             24 hour format that want to UNLOCK the doors system. Again,
  1928.             this time cannot be ACROSS midnight.  If you did NOT enable
  1929.             locking, enter 00:00 in this field.
  1930.  
  1931.          FIELD 18: Use the AUTO ONE DOOR EXECUTE FEATURE ?  (Y/n):
  1932.             LiveCat has the ability to automatically run a door IF it
  1933.             the ONLY door in a given menu.  When the user enters
  1934.             LIVECAT from WILDCAT for the first time, and if the MENU
  1935.             chosen only has one door in it, LiveCat will go ahead and
  1936.             automatically run the door for the user instead of
  1937.             presenting the menu.  When the user terminates the door,
  1938.             it will return to the LiveCat menu chosen when the user
  1939.             first entered LiveCat.  Subsequent changes to this menu
  1940.             by use of the 'Z' key, do NOT automatcially run the
  1941.             single door, only on original entry from the BBS into
  1942.             LiveCat does the feature have any effect.  If you want to
  1943.             USE the feature, enter Y otherwise enter N.
  1944.  
  1945.          FIELD 19: What is your SYSOP security level in the BBS (XXXX):
  1946.             Normally in Wildcat! this would be 1000.  But some sysops
  1947.             use different levels.  Whatever level you have set as
  1948.             your OWN level in Wildcat! is what you should enter here.
  1949.  
  1950.          FIELD 20: Use EMS during swap if available (Y/N)?
  1951.             LiveCat 3.1  employs swapping  techniques to  make the  maximum
  1952.             amount of memory available to a door when it is being run.
  1953.  
  1954.  
  1955.  
  1956.  
  1957.  
  1958.  
  1959.        LiveCat Version 3.1             33                     06-09-91
  1960.  
  1961.             In order to  accomplish this, LiveCat  will swap all  but about
  1962.             2-4k of itself out of memory when it executes a door.  You  may
  1963.             use either  DISK for  this swap  information to  be temporarily
  1964.             stored, or  if available  you may  use EMS  memory to  hold the
  1965.             swap data. Our  EMS routines SHOULD  work with EMS  DRIVES from
  1966.             3.2 up.  It  is NOT uncommon to  find EMS drivers however  that
  1967.             do not function totally  as expected.  If  you set the use  EMS
  1968.             flag  to  Y  and  experience  problems  with  LiveCat reloading
  1969.             itself when returning from  a door, simply forget  EMS swapping
  1970.             and use DISK  swapping instead by  setting the flag  to N.   If
  1971.             you use DISK swapping, you  may direct that the temporary  swap
  1972.             file  be  placed  on  a  drive  other  than your default drive,
  1973.             including a ram disk.  If you wish to use RAM DISK to hold  the
  1974.             temporary  swap  file  you  must  put  a  TEMP variable in your
  1975.             environment. This  is done  during autoexec.bat  by saying: SET
  1976.             TEMP=D:\.  If D: is your ram disk, then the swap files will  be
  1977.             placed there instead  of the default  drive and directory.   If
  1978.             LiveCat does not find a TEMP variable in your environment  then
  1979.             the default location  of the temporary  swap files will  be the
  1980.             current drive and directory.  CAUTION, if using a ram disk,  it
  1981.             MUST be  large enough  to hold  the swap  file for EACH running
  1982.             node simulaneously!!  The swap  file is about 192k in  size for
  1983.             each node, so if you have  3 nodes running and wish to  use ram
  1984.             disk for all of  them, ram disk size  must be a minum  3 x 192k
  1985.             so that a swapping error  will not occur because the  ram drive
  1986.             is full.
  1987.  
  1988.        FIELD 21: Unlock DTE for ENTIRE Monitor Session (global) (Y/N)
  1989.  
  1990.             This field is new in version 3.1.  If you are running with DTE
  1991.             locked you may set this field to Y and the DTE will be UNLOCKED
  1992.             when LiveCat starts up and will REMAIN unlocked until LiveCat
  1993.             shuts down and returns to Wildcat!.  If you answer Y here, the
  1994.             field in each SCRIPT that controls DTE lock/unlock for each
  1995.             door is ignored.  If you answer N to this field, LiveCat will
  1996.             NOT unlock the DTE unless the script for any given door tells
  1997.             it to, in which case the DTE will be unlocked for that single
  1998.             door run and the RELOCKED when the door completes and LiveCat
  1999.             restarts.
  2000.  
  2001.        FIELD 22:  DRIVE REMAPS:
  2002.             These  9  fields  will  be  used  ONLY  if  you  are  using   a
  2003.             peer-to-peer network in which  physical drives may be  known to
  2004.             different nodes  by differnt  names.   If you  are NOT  using a
  2005.             peer-to-peer  network  such  as  Lantastic,  simply leave these
  2006.             fields blank.
  2007.  
  2008.             These  things  can  be  confusing  and  tricky,  but  if you've
  2009.             managed to  get your  Lantastic configured  in such  a way that
  2010.             all physical  drives are  not known  by the  same names  to all
  2011.             nodes, then  you will  have to  use these  so LiveCat will know
  2012.             how to find the doors on different drives.
  2013.  
  2014.             You are allowed to alias upto 9 drives.  These are drives  that
  2015.             LiveCat will have to look for  the doors on.  For instance,  on
  2016.             node 1, your doors may be on a drive named C:, but on node  two
  2017.             these same doors  are on a  drive named F:  because of the  way
  2018.             you mapped your network.
  2019.  
  2020.  
  2021.  
  2022.  
  2023.        LiveCat Version 3.1             34                     06-09-91
  2024.  
  2025.             When configuring NODE  1, drive remap  1 would get  a C: placed
  2026.             in in it, the other can be  blank if all your doors are on  the
  2027.             same physical drive.  If you have doors on more than one  drive
  2028.             such as C: and D: then use C: in position 1 and D: in  position
  2029.             2.
  2030.  
  2031.             When configuring nodes 2 thru x,  the C: and D: drives of  node
  2032.             1 MAY  be known  as F:  and G:,  so on  these nodes  put F:  in
  2033.             position 1 and G: in position 2.
  2034.  
  2035.             You  USE  these  drive  alias's  in  your  scripts by using the
  2036.             replacable parameters  %1 thru  %9.   At runtime,  LiveCat will
  2037.             replace them with  drive alias from  the configuration on  that
  2038.             node.   Using the  above drive  remap alias's  heres what would
  2039.             happpen:
  2040.  
  2041.             SCRIPT:
  2042.             %1
  2043.             CD \DOORS\TW500
  2044.             TW2 /P %D\%I\CALLINFO.BBS
  2045.  
  2046.             This script assumes a drive  change will have to take  place on
  2047.             at least one node to get to the drive where the door is at.  If
  2048.             run from node 1 the runtime script will become:
  2049.  
  2050.             C:
  2051.             CD \DOORS\TW500
  2052.             TW2 /P C:\WILDCAT\NODE1\CALLINFO.BBS
  2053.  
  2054.             when run from NODE 2 the runtime script would be:
  2055.             F:
  2056.             CD \DOORS\TW500
  2057.             TW2 /P C:\WILDCAT\NODE2\CALLINFO.BBS
  2058.  
  2059.             The %1 is  replaced with the  alias drive from  the MONITOR.CFG
  2060.             for that  particular node.   Using this  you can  have doors on
  2061.             upto 9 drives in your  system, all known by different  names by
  2062.             different nodes, and still use the same script for all nodes.
  2063.  
  2064.  
  2065.  
  2066.  
  2067.  
  2068.  
  2069.  
  2070.  
  2071.  
  2072.  
  2073.  
  2074.  
  2075.  
  2076.  
  2077.  
  2078.  
  2079.  
  2080.  
  2081.  
  2082.  
  2083.  
  2084.  
  2085.  
  2086.  
  2087.        LiveCat Version 3.1             35                     06-09-91
  2088.  
  2089.          [[ APPENDIX B - EXPLAINATION OF MENU LEVEL SECURITY ]]
  2090.  
  2091.         In  previous  versions  of  LiveCat  the  'Z' key menu changes were
  2092.        driven by  an INTERNAL  menu formatting  routine.   In 3.1  this has
  2093.        been changed to be driven from an EXTERNAL menu file.
  2094.  
  2095.         When the user presses 'Z' to 'Change Menus' while in LiveCat,  they
  2096.        are presented a menu of the other menus that are available for  them
  2097.        to  change  to.   You  MUST  create  and  format  this menu yourself
  2098.        according to specific conventions.
  2099.  
  2100.        You may have TWO of these 'Z' key menus, an Ansi Color menu and an
  2101.        Ascii menu.  They MUST be named:
  2102.  
  2103.                             Ansi Color 'Z' key menu = MENU.ANS
  2104.                             Ascii 'Z' key menu      = MENU.BBS
  2105.  
  2106.         In addition to the two REQUIRED files, you may have SECURITY  LEVEL
  2107.        SPECIFIC 'Z' key menus that will be displayed to users with  certain
  2108.        security levels.
  2109.  
  2110.         Before going  any further,  let me  say that  you CAN  get lost and
  2111.        confused in  the area  of security  level menus  unless you are VERY
  2112.        familiar with LiveCat and doors  in general.  Tackle this  part only
  2113.        when you  feel you  are ready,  it is  NOT necessary  to the  proper
  2114.        operation of LiveCat.  Using these features it is entirely  possible
  2115.        to  get  some  doors  installed  into  your system and with improper
  2116.        coding of security levels, they will never been seen again!
  2117.  
  2118.  
  2119.         The naming convention of these OPTIONAL level specific 'Z' key menus
  2120.        is as as follows:
  2121.  
  2122.           Ansi Color 'Z' Key Security menus = MENUXXXX.SCR
  2123.                Ascii 'Z' Key Security menus = MENUXXXX.BBS
  2124.  
  2125.         In the  above, the  XXXX is  substituted with  the numeric security
  2126.        level allowed to view this menu..
  2127.  
  2128.         For instance, the  user that logs  on has a  security level of  90.
  2129.        When  they  hit  the  Z  key,  the  monitor  will  look  for  either
  2130.        MENU90.SCR or MENU90.BBS depending on whether color is on or not.
  2131.  
  2132.         If it  cannot find  the 90  file it  will use  standard MENU.ANS or
  2133.        MENU.BBS.   You need  NOT use  the security  level specific menus if
  2134.        you do not want  to, but you MUST  create the standard MENU.ANS  and
  2135.        MENU.BBS
  2136.  
  2137.         There are several things you  need to take into consideration  when
  2138.        using the  new feature  that security  level protects  menus in your
  2139.        system.
  2140.  
  2141.  
  2142.  
  2143.  
  2144.  
  2145.  
  2146.  
  2147.  
  2148.  
  2149.  
  2150.  
  2151.        LiveCat Version 3.1             36                     06-09-91
  2152.  
  2153.         Basically,  this  is  very  easy  to  do using GAP and PCBoard, and
  2154.        considerably more difficult using Spitfire and Wildcat!
  2155.  
  2156.         The problem is in
  2157.              1.) What you show to  the user as DOOR CHOICES in the BBS  and
  2158.                  how  you  will  keep  the   user  from  seeing  the   MENU
  2159.                  selections up  there.    GAP   and PCBoard   allow you  to
  2160.                  have different  door menus  for each forum, makes it  easy
  2161.                  to control what a user  sees.  Wildcat! doesn't have  this
  2162.                  feature nor  will it  allow security  level door  menus so
  2163.                  you don't  have much  choice, the  user will  SEE that the
  2164.                  option is  available when  they hit  D for  doors and  are
  2165.                  shown the DOORS.SCR  menu.  When  they get to  the monitor
  2166.                  though those protected  menus won't show.  I believe  this
  2167.                  is also the case with Spitfire.
  2168.  
  2169.              2.) Stacking the MENUS and LIVEX - DOORX bat files so that
  2170.                  menus are presented in order of level access.
  2171.  
  2172.  
  2173.          Basically, the only thing you have to do to properly support  this
  2174.        feature is to edit your MNAMES.LST file to insert the levels.   They
  2175.        SHOULD be stacked in order  of LEVELS PERMITTED TO ACCESS  THE MENU,
  2176.        lowest to highest.
  2177.  
  2178.        Here is what mine looks like:
  2179.  
  2180.               WARGAMES 15
  2181.               ADVENTUR 15
  2182.               TGTRIVIA 15
  2183.               QUICKFUN 15
  2184.               DATABASE 15
  2185.               SIMULATE 15
  2186.               ADULT 28
  2187.               SYSOPSDP 90
  2188.  
  2189.          As you see, the security levels go lowest to highest.  Your  DOORS
  2190.        MENU in the BBS Should REFLECT THIS SETUP thusly:
  2191.  
  2192.        * NOTE * Door #7 below is my Mail Reader door, I do NOT run my mail
  2193.        door from within LiveCat.  Because it does not run INSIDE LiveCat,
  2194.        it does not appear in the MNAMES.LST file described above.
  2195.  
  2196.             DOOR #1       DOOR #2       DOOR #3       DOOR #4
  2197.          ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐
  2198.          │    WAR    │ │ ADVENTURE │ │  TRIVIA   │ │ EASY FUN  │
  2199.          │   GAMES   │ │   GAMES   │ │   GAMES   │ │  GAMES    │
  2200.          └───────────┘ └───────────┘ └───────────┘ └───────────┘
  2201.  
  2202.             DOOR #5       DOOR #6       DOOR #7       DOOR #8
  2203.          ┌───────────┐ ┌───────────┐ ┌───────────┐ ┌───────────┐
  2204.          │DATABASE   │ │           │ │ MEGAMAIL  │ │ ADULT     │
  2205.          │  UTILITIES│ │SIMULATIONS│ │FORUM MAIL │ │     GAMES │
  2206.          └───────────┘ └───────────┘ └───────────┘ └───────────┘
  2207.  
  2208.             DOOR #9
  2209.          ┌───────────┐
  2210.          │ DEMOS FOR │
  2211.          │  SYSOPS   │
  2212.          └───────────┘
  2213.  
  2214.  
  2215.        LiveCat Version 3.1             37                     06-09-91
  2216.  
  2217.         In GAP  and PCBoard,  the user  with a  security level  of 20 would
  2218.        never SEE the last two selections  unless they were in a forum  that
  2219.        permitted viewing of this menu,  from the main board they  would see
  2220.        ONLY door #1 thru 7.
  2221.  
  2222.         In Wildcat!  and Spitfire  they will  see the  whole menu, but will
  2223.        only be able to open 1 thru 7 provided you have your doors  security
  2224.        files  for  the  BBS  setup  to  match  the  MNAMES.LST  levels.  In
  2225.        Wildcat! this  is done  in Makewild.
  2226.  
  2227.         I think you'll be  able to figure this  out if you want  to use it.
  2228.        You do NOT need  to use the level  protections if you don't  want to
  2229.        but you must still edit the MNAMES.LST file to put in the levels.
  2230.  
  2231.  
  2232.  
  2233.  
  2234.  
  2235.  
  2236.  
  2237.  
  2238.  
  2239.  
  2240.  
  2241.  
  2242.  
  2243.  
  2244.  
  2245.  
  2246.  
  2247.  
  2248.  
  2249.  
  2250.  
  2251.  
  2252.  
  2253.  
  2254.  
  2255.  
  2256.  
  2257.  
  2258.  
  2259.  
  2260.  
  2261.  
  2262.  
  2263.  
  2264.  
  2265.  
  2266.  
  2267.  
  2268.  
  2269.  
  2270.  
  2271.  
  2272.  
  2273.  
  2274.  
  2275.  
  2276.  
  2277.  
  2278.  
  2279.        LiveCat Version 3.1             38                     06-09-91
  2280.  
  2281.        [[ APPENDIX C - DOOR SUPPORT FOR OTHER BBS TYPES ]]
  2282.  
  2283.         LiveCat 3.1 automatically supports  the following door types:   The
  2284.        codes  displayed  in  the  editor's  attribute entry window have the
  2285.        following meaning.
  2286.  
  2287.            W =  Wildcat 1.10/1.11  format. Required  by most  Wildcat doors
  2288.                available   at   this   writing.   The   file   produced  is
  2289.                CALLINFO.BBS and is placed in your NODE HOME directories.
  2290.  
  2291.            2  =  Wildcat  1.12  format.   Required  by some newer doors for
  2292.                Wildcat  such  as  Masters  of  the Universe. This type will
  2293.                become  popular   very  shortly.   The  file   produced   is
  2294.                CALLINFO.BBS and is placed in your NODE HOME directories.
  2295.  
  2296.            3 =   Wildcat 2.xx  format.   Required by  the newest  doors for
  2297.                Wildcat!  This type is becoming the most popular format  for
  2298.                Wildcat  doors.   The  file  produced  is  CALLINFO.BBS   in
  2299.                Wildcat 2.00 thru  2.50 format.
  2300.  
  2301.            P =  PCBoard 11.x  thru 12.x  format.   This is  compatible with
  2302.                most known  doors that  run under  the PCBoard  12.x system.
  2303.                Files produced  are PCBOARD.SYS  and PCBOARD.DAT  and placed
  2304.                in the NODE HOME directories
  2305.  
  2306.            4 = PCBoard 14.x. This is compatible with most known doors  that
  2307.                are  designed  to  be  run  under  the  PCBoard 14.x system.
  2308.                Files produced  are PCBOARD.SYS,  PCBOARD.DAT and  USERS and
  2309.                placed in the NODE HOME directories.
  2310.  
  2311.            R = RBBS 15.1c+ format.  This format is compatible with  version
  2312.                15.1c  and  up  of  RBBS-PC.  LiveCat produces a file called
  2313.                DORINFO1.DEF from  which the  door program  will obtain it's
  2314.                callers information.  DORINFO1.DEF is placed in the  WILDCAT
  2315.                directory. If you are running your system on COM1, the  RBBS
  2316.                door will use this file directly, if your system is  running
  2317.                COM2, the  DORINFO1.DEF MUST  BE RENAMED  TO DORINFO2.DEF in
  2318.                your script  entry and  then either  file must  be copied to
  2319.                the directory in which the  door itself will run.   Any RBBS
  2320.                door in a download area that  you see with a dating of  0288
  2321.                or later in it's  name such as CAVE0288.ARC  or KING0488.ARC
  2322.                can be run by LiveCat.
  2323.  
  2324.            G = GAP format.   This format is compatible with  doors written
  2325.                to run under the GAP  BBS system.  LiveCat produces  a file
  2326.                called DOOR.SYS and places it in the NODE HOME directories.
  2327.  
  2328.            S =  SPITFIRE 2.x  and 3.x  format.   This format is compatible
  2329.                with doors written to  run under the SPITFIRE  BBS. LiveCat
  2330.                produces a  file called  SFDOORS.DAT and  places it  in the
  2331.                NODE HOME directories.
  2332.  
  2333.            Q = QBBS format.   This format is presently capable  of running
  2334.                ONLY the QBBS version of TRADE WARS 1000.
  2335.  
  2336.          Other door types will be added on an 'as needed' basis.
  2337.  
  2338.  
  2339.  
  2340.  
  2341.  
  2342.  
  2343.        LiveCat Version 3.1             39                     06-09-91
  2344.  
  2345.         [[ APPENDIX D - DTE LOCK UNLOCK SYSTEM ]]
  2346.  
  2347.         One of the features  added in 3.1 that  is most important to  users
  2348.        of high speed  modems is the  one that allows  Locking and Unlocking
  2349.        of modem DTE on the fly for any door that requires it.
  2350.  
  2351.         If you ran the 2.x to 3.x conversion utility, the flag in the  door
  2352.        script that tells the MONITOR  to unlock the DTE before  running the
  2353.        door was set  by default to  Y, meaning that  each time the  door is
  2354.        run, if the modem  has it's DTE locked,  it will be UNLOCKED  before
  2355.        the door is run, and then  RELOCKED when the door is terminated  and
  2356.        the MONITOR restarts.  Your  system should run just fine  using this
  2357.        default for all doors, but, since  many of the newer doors WILL  run
  2358.        at baud rates of  19200 and above, there's  really no need to  waste
  2359.        the time  of unlocking  and relocking  the DTE  on doors  that don't
  2360.        need it.  If you want,  start up LSEDIT and go into  the appropriate
  2361.        scripts and change  the LOCK DTE  flag from Y  to N for  those doors
  2362.        that you do NOT want to unlock the DTE before running.
  2363.  
  2364.          In  order  to  USE  the  DTE  features  that the 3.1 Monitor makes
  2365.        available, you must make a change to your modem setup.  This  change
  2366.        is VERY simple.   You must make  sure that the  S2 register in  your
  2367.        modem is set to ONE, or S2=1.
  2368.  
  2369.          If you are using an HST,  you must also make sure that  dip switch
  2370.        #9 is DOWN.
  2371.  
  2372.         Our exclusive  method of  DTE control  is PROPRIETARY  and works on
  2373.        MOST ALL MODEMS without change.   It's been succesfully tested on  a
  2374.        variety of  high speed  modems without  problems, plus  it adds only
  2375.        about 3  seconds to  the door  execution sequence  unlike some other
  2376.        external programs that  are complex in  operation and quite  slow as
  2377.        well as modem sensitive.   The whole KEY to  using the DTE  features
  2378.        are setting your modem to S2=1 and if an HST, setting dip switch  #9
  2379.        DOWN.
  2380.  
  2381.         Remember that  there are  some doors  that will  run sucessfully at
  2382.        19200 baud and  below but will  NOT run at  38400 baud.   If this is
  2383.        the case, the door MUST be set  to UNLOCK the dte at ALL baud  rates
  2384.        or 38400 baud modems will not be able to use the door.
  2385.  
  2386.         The last point that you must  know about when using the DTE  unlock
  2387.        features have to  do with the  older pre 1440  versions of the  HST.
  2388.        These older HST modems will NOT  permit the modem to be placed  into
  2389.        command  mode  if  an  ARQ/MNP  connection  is  in progress.  If you
  2390.        attempt to  place the  modem into  command mode  during this type of
  2391.        connection, the modem immediately drops carrier and hangs up.   What
  2392.        this simply means is that if you have an old HST, and a caller  with
  2393.        another modem connects in either ARQ or MNP to you, your modem  will
  2394.        drop carrier and  hang up the  instant they try  to run a  door that
  2395.        unlocks the DTE before  running.  This is  NORMAL for the older  HST
  2396.        modems and U.S. Robotics says there is nothing can be done about  it
  2397.        so it's something you'll just have to live with.
  2398.  
  2399.         The only way  to know how  a door will  react to DTE  locking is to
  2400.        test it thouroughly  at all speeds  to determine what  will work and
  2401.        what  will  not  and  then  set  the  DTE  flag  in  the door script
  2402.        appropriately.
  2403.  
  2404.  
  2405.  
  2406.  
  2407.        LiveCat Version 3.1             40                     06-09-91
  2408.  
  2409.         [[ APPENDIX E - REPLACABLE PARAMETER SCRIPT LANGUAGE ]]
  2410.  
  2411.         Currently,  the   3.1  release   has  implemented   a  new   SCRIPT
  2412.        INTERPRETER  language  to  make  it  possible  to  run doors of many
  2413.        different  types  that  do  not  use  standard command line formats.
  2414.        Below  are  the  imbedded  script  commands  that  you  can  use  to
  2415.        configure an oddball door.
  2416.  
  2417.         If  you  are  using  the  SINGLE  USER version of LiveCat, you will
  2418.        probably  have   very  few   occassions  to   need  the   replacable
  2419.        parameters,  if  however  you  are  running  one  of  the MULTI-USER
  2420.        versions of LiveCat,  EACH and EVERY  script MUST make  use of these
  2421.        replacable parameters.
  2422.  
  2423.             %D - Replaced at RUNTIME by the CURRENT DRIVE  LETTER and COLON
  2424.  
  2425.             %B  - Replaced at RUNTIME by the CALLERS BAUD RATE
  2426.  
  2427.             %C  - Replaced at RUNTIME by the COMPORT # for this node
  2428.  
  2429.             %F  - Replaced at RUNTIME by SYSOP FIRST name
  2430.  
  2431.             %L  - Replaced at RUNTIME by SYSOP LAST name
  2432.  
  2433.             %U  - Replaced at RUNTIME by USER FULL NAME
  2434.  
  2435.             %P  - Pyroto Moutain style PORT NUMBER
  2436.  
  2437.             %T  - Replaced at runtime with TIME FOR THIS DOOR
  2438.  
  2439.             %I  - Replaced at runtime with name of NODE HOME DIRECTORY
  2440.  
  2441.             %N  - Replaced at runtime with the CURRENT NODE NUMBER.
  2442.  
  2443.             %1 thrun % 9 - Replaced at runtime with Remapped Drive alias
  2444.                            names.
  2445.  
  2446.         When you enter these replaceable parameters, the letter MUST
  2447.        be in UPPER case and it MUST be preceded by the percent sign.
  2448.  
  2449.        HERE IS AN EXAMPLE OF REPLACABLE parameters.
  2450.  
  2451.        Pyroto is one of the  wierd ducks that require almost  EVERYTHING
  2452.        to passed  to  on  a  command  line.   Here's  how  you'd  do  it
  2453.        with replacable parameters:
  2454.  
  2455.          cd \pyroto
  2456.          pyroto /DOOR/%U/%T/%P/
  2457.  
  2458.        Always mark  this kind  of door  that is  NOT dependent  on a caller
  2459.        file  such  as  CALLINFO.BBS  or  PCBOARD.SYS  as a 'W' type Wildcat
  2460.        door.
  2461.  
  2462.        At runtime the  above script would  actually be constructed  to read
  2463.        (assuming I've given  the user 40  minutes for the  door and running
  2464.        on PORT 2) to be:
  2465.  
  2466.          PYROTO /DOOR/STEVE COX/40/1016/
  2467.  
  2468.  
  2469.  
  2470.  
  2471.        LiveCat Version 3.1             41                     06-09-91
  2472.  
  2473.        See how that works, this allows you almost TOTAL flexibility in  how
  2474.        you would  set up  a door,  with the  existing replacable parameters
  2475.        plus the  ones I  intend to  add later,  you should  be able  to run
  2476.        virtually any door from any  location using any drive your  mind can
  2477.        dream up.  Thats all  thats required  and covers  just about all the
  2478.        possibilities you might run into.
  2479.  
  2480.  
  2481.  
  2482.  
  2483.  
  2484.  
  2485.  
  2486.  
  2487.  
  2488.  
  2489.  
  2490.  
  2491.  
  2492.  
  2493.  
  2494.  
  2495.  
  2496.  
  2497.  
  2498.  
  2499.  
  2500.  
  2501.  
  2502.  
  2503.  
  2504.  
  2505.  
  2506.  
  2507.  
  2508.  
  2509.  
  2510.  
  2511.  
  2512.  
  2513.  
  2514.  
  2515.  
  2516.  
  2517.  
  2518.  
  2519.  
  2520.  
  2521.  
  2522.  
  2523.  
  2524.  
  2525.  
  2526.  
  2527.  
  2528.  
  2529.  
  2530.  
  2531.  
  2532.  
  2533.  
  2534.  
  2535.        LiveCat Version 3.1             42                     06-09-91
  2536.  
  2537.         [[ APPENDIX F - RUNNING PCBOARD, RBBS and WILDCAT DOORS ]]
  2538.  
  2539.          ** PCBOARD DOORS **
  2540.  
  2541.          Of all the door types available, doors written for PCBoard can  be
  2542.        the most exasperating to get running on a NON PCBoard system.   Here
  2543.        are some tips and  tricks that I and  other users have learned  over
  2544.        the years for running these little beasts.
  2545.  
  2546.          PCBoard doors can presently appear in three different flavors.
  2547.  
  2548.          Doors for PCBoard V 11.x will run just fine unmodified in any way.
  2549.  
  2550.          Doors for PCBoard V 12.x REQUIRE the presence of two files  called
  2551.        PCBOARD.DAT  and  PCBOARD.SYS  in  your  WILDCAT  directory  AND the
  2552.        PCBOARD.DAT MUST be in 12.x format. Both of these files are  created
  2553.        on the fly by LiveCat as need in response to a door marked as a  'P'
  2554.        type door with LsEdit.
  2555.  
  2556.         Doors for PCBoard  V 14.x generally  REQUIRE the presence  of three
  2557.        files, PCBOARD.SYS, PCBOARD.DAT and USERS in your WILDCAT  directory
  2558.        AND  the  PCBOARD.DAT  MUST  be  in  14.x format. All three of these
  2559.        files are build on the fly  by LiveCat in response to a  door marked
  2560.        as a '4' type door with LsEdit.
  2561.  
  2562.        MOST PCB doors  regardless of the  type code, 2  or 4, require  that
  2563.        the door  itself have  a configuration  file created  it for  it and
  2564.        present in the directory with the  door.  This is where most  people
  2565.        run into trouble.
  2566.  
  2567.         I always refer to these  door specific configuration files as  .CFG
  2568.        files so I'll refer to them like from now on.
  2569.  
  2570.         Here is what could be  called a 'common' procedure for  running any
  2571.        type of PCBoard  door in your  system using LiveCat,  although there
  2572.        really is no such thing as a  'common' way. This will work on a  LOT
  2573.        of them but not all.
  2574.  
  2575.         Create a  .CFG for  the PCBdoor  according to  the authors
  2576.        instructions.
  2577.  
  2578.         Most always these .CFG files will  ask for a line telling the  door
  2579.         WHERE to locate the PCBOARD.SYS and .DAT files that it should  read
  2580.         when it starts up.
  2581.  
  2582.           LiveCat ALWAYS creates these  files in the NODE  HOME directories
  2583.         and thats  where you  should tell  the .CFG  file they  are at.  If
  2584.         your NODE  1 directory is named: C:\WC30\WCWORK\NODE1 then the path
  2585.         line in the .CFG for the door would read:
  2586.         C:\WC30\WCWORK\NODE1\PCBOARD.SYS
  2587.  
  2588.         In your  LiveCat execution  script to  RUN this  door you generally
  2589.         must give the name  of the .CFG file  that the door is  supposed to
  2590.         use  when  it  starts  up.   A  popular  PCBoard  door to use as an
  2591.         example is Card Guppies by Doug Peterson, an excellent door  author
  2592.         by  the  way.   Guppies  is  started  in  the  following way by the
  2593.         script:
  2594.  
  2595.           CD \DOORS\GUPPIES
  2596.           GUPPIES GUP-1.CFG
  2597.  
  2598.  
  2599.        LiveCat Version 3.1             43                     06-09-91
  2600.  
  2601.           The GUP-1.CFG file has a line in it that says:
  2602.           C:\WC30\WCWORK\NODE1\PCBOARD.SYS
  2603.  
  2604.         This  door  should  run  without  problems  using  the above steps.
  2605.        Other PCBoard doors can require  MUCH more work to get  running than
  2606.        this and you will  be on your own  to experiment with these  since I
  2607.        could  fill  volumes  on  the  variations  you will encounter.  Some
  2608.        PCBoard doors you will  simply NOT be able  to run because they  tie
  2609.        to  tightly  to  the  BBS  for  them  to be supported in NON PCBoard
  2610.        environments.
  2611.  
  2612.         In  some  cases,  the  PCBoard  door  MAY require that the files be
  2613.        located a bit more specifically than the above example  illustrates.
  2614.        Some of them might actually  REQUIRE that the DIRECTORIES for  these
  2615.        files conform exactly to the PCBoard standard.
  2616.  
  2617.         If  this  is  the  case,  you  might  need  to make a PCB directory
  2618.        someplace on your  disk, put a  copy of the  appropriate PCBOARD.DAT
  2619.        file in it and manually edit it with a text editor to change ALL  of
  2620.        the  path  names  in  the  file  to  reflect  x:\PCB  instead of the
  2621.        directories defaulted to by LiveCat when it creates these files.
  2622.  
  2623.         In this case,  your door script  to run these  types of doors  must
  2624.        COPY  the  PCBOARD.SYS  and  USERS  file  _NOT_ PCBOARD.DAT from the
  2625.        NODE1 directory, into this  dummy set of directories  before running
  2626.        the door.   The .CFG  for the  door would  of course  point to  this
  2627.        dummy PCB directory to find it's files.
  2628.  
  2629.         In other, more extreme cases it  might be necessary to do the  same
  2630.        as above but  put the PCBOARD.DAT  directly into the  directory with
  2631.        the DOOR, manually  configure it with  an editor to  change the path
  2632.        names to  the point  to the  doors own  directory, and  THEN in your
  2633.        script, copy  the new  PCBOARD.SYS and  USERS file  from the WILDCAT
  2634.        directory,  _NOT_  the  PCBOARD.DAT,  directory  into  the doors own
  2635.        directory.  The .CFG for the  door would of course have to  look for
  2636.        it there.
  2637.  
  2638.         As you  can see,  running PCB  doors under  some circumstances  can
  2639.        become quite  involved.   Only experience  and experimentation  will
  2640.        allow you  to develop  the techniques  to quickly  get the different
  2641.        variations going.
  2642.  
  2643.        Remember that all  doors that require  a .CFG, MUST  have a separate
  2644.        .CFG  for  EACH  NODE  in  your  system  or  they  will not function
  2645.        properly.
  2646.  
  2647.        ** RBBS-PC DOORS **
  2648.         LiveCat automatically supports doors for RBBS-PC Version 15.1c  and
  2649.        up.   These  doors  require   that  a  file  name  DORINFO1.DEF   or
  2650.        DORINFO2.DEF be available  when the door  is run.   The DORINFO1.DEF
  2651.        file  will  be  required  if  your  system  runs  on  COM1  and  the
  2652.        DORINFO2.DEF will be required on a system running on COM2.
  2653.  
  2654.         Most RBBS-PC doors  that use DOORINFO1.DEF  will NOT look  down any
  2655.        path to find the .DEF file.  In your script you must first copy  the
  2656.        DOORINFO1.DEF  file  from  your  NODE  HOME  directory where LiveCat
  2657.        placed it in  response to an  'R' type door  code, to the  directory
  2658.        where the  RBBS door  is at  before changing  over there and running
  2659.        the door.
  2660.  
  2661.  
  2662.  
  2663.        LiveCat Version 3.1             44                     06-09-91
  2664.  
  2665.         LiveCat only produces the DORINFO1.DEF  file for com1 systems.   If
  2666.        your system is running on com2, you must rename the dorinfo1.def  to
  2667.        dorinfo2.def during the copy operation from the NODE HOME  directory
  2668.        over to where the door is located.
  2669.  
  2670.        ** WILDCAT DOORS **
  2671.         Wildcat  doors  come  in  three  different  flavors now.  Doors for
  2672.        Wildcat version 1.10 and 1.11 can be marked in the ATTRIBUTE  screen
  2673.        of the  editor as  'W' type  doors.   Some newer  Wildcat doors  are
  2674.        specific to  Wildcat Versions  1.12 and  1.13.   To run  these, mark
  2675.        them  as  a  '2'  type  door  with  the  editor.  The latest type of
  2676.        Wildcat door is the  one created for Wildcat!   2.0 and above,  mark
  2677.        these as a '3' type door.
  2678.  
  2679.         In all cases, unless the door documentation TELLS you  SPECIFICALLY
  2680.        which type it  is, mark it  as a 3  type door, if  it won't run that
  2681.        way, THEN mark  it as a  2 type door  and try again  and if it still
  2682.        won't go, mark it as a 'W'  type.  If after all this it  still won't
  2683.        go, toss it!
  2684.  
  2685.  
  2686.          * HOW LIVECAT RUNS A DOOR *
  2687.  
  2688.         The  conversion  process  that  LiveCat  goes  through to build the
  2689.        conversion files for the different types of doors are this:
  2690.  
  2691.         Doors marked as a 'P' or  '4' type door get a files  created called
  2692.        PCBOARD.SYS, and PCBOARD.SYS and optionally, USERS. These files  are
  2693.        created in your  NODE HOME directories  and the door  .CFG must look
  2694.        for them there.
  2695.  
  2696.         Doors marked  as a  'W', '2'  or '3'  type door  get a file created
  2697.        called CALLINFO.BBS in specific  format of the indicated  version of
  2698.        Wildcat!. This file is placed in your NODE HOME directories and  the
  2699.        door .CFG must look for it there.
  2700.  
  2701.         Doors  marked  as  an  'R'  type  door  get  a  file created called
  2702.        DOORINFO1.DEF.  This  file is placed  in your NODE  HOME directories
  2703.        and MUST be copied by your script into the directory where the  door
  2704.        is at  BEFORE you  try to  execute the  door.   If you  happen to be
  2705.        running on COM2 instead of COM1  then you must also rename the  file
  2706.        from DOORINFO1.DEF to DOORINFO2.DEF.
  2707.  
  2708.         This of course can be  accomplished during the copy operation  from
  2709.        the NODE HOME directory to the target door directory.
  2710.  
  2711.         Doors  marked  as  a  'G'  type  door  get  a  file  created called
  2712.        DOOR.SYS.  This file is placed  in your NODE HOME directory and  the
  2713.        door must look for it there.
  2714.  
  2715.         In any door that has a MULTI BOARD interface and you get to  choose
  2716.        which interface you'd like to run, the order of preference is this:
  2717.  
  2718.             Wildcat      = 1st Choice DOOR.SYS     = 2nd Choice
  2719.             PCBoard 12.x = 3rd Choice PCBoard 14.x = 4th Choice
  2720.             RBBS  = 5th Choice.
  2721.  
  2722.  
  2723.  
  2724.  
  2725.  
  2726.  
  2727.        LiveCat Version 3.1             45                     06-09-91
  2728.  
  2729.         Always use the interface for the BBS system you are running if  you
  2730.        can. In other words, if you are running PCB 14.0 then choose the PCB
  2731.        14.0 interface for the door, NOT something else.
  2732.  
  2733.         Experience has taught me that the Wildcat CALLINFO.BBS and the  GAP
  2734.        DOOR.SYS interfaces are  the most reliable  and easy to  use, choose
  2735.        them whenever you can.
  2736.  
  2737.  
  2738.  
  2739.  
  2740.  
  2741.  
  2742.  
  2743.  
  2744.  
  2745.  
  2746.  
  2747.  
  2748.  
  2749.  
  2750.  
  2751.  
  2752.  
  2753.  
  2754.  
  2755.  
  2756.  
  2757.  
  2758.  
  2759.  
  2760.  
  2761.  
  2762.  
  2763.  
  2764.  
  2765.  
  2766.  
  2767.  
  2768.  
  2769.  
  2770.  
  2771.  
  2772.  
  2773.  
  2774.  
  2775.  
  2776.  
  2777.  
  2778.  
  2779.  
  2780.  
  2781.  
  2782.  
  2783.  
  2784.  
  2785.  
  2786.  
  2787.  
  2788.  
  2789.  
  2790.  
  2791.        LiveCat Version 3.1             46                     06-09-91
  2792.  
  2793.         [[ APPENDIX G - RUNNING SECONDARY COPIES OF WILDCAT AS FORUMS ]]
  2794.  
  2795.        ** DISCLAIMER **  ** THIS IS NOT SUPPORTED FOR WILDCAT 3.0!!!!
  2796.  
  2797.           The  descriptions  that  follow  for  running secondary copies of
  2798.        Wildcat! as sigs under LiveCat  3.1 have been tested in  SINGLE NODE
  2799.        environments only.  NO guarantee is  made as to the accuracy of  the
  2800.        descriptions as related to multi-node operation.
  2801.  
  2802.        The  descriptions  of  scripts  and  operations are single user, you
  2803.        will  be  on  your  own  to  figure  out  the  variants  related  to
  2804.        Multi-Node operation of these sigs.
  2805.  
  2806.        The 3.1  release of  LiveCat has  gone to  some lengths  to make  it
  2807.        possible for  you to  run secondary  copies of  Wildcat!   as forums
  2808.        underneath LiveCat.
  2809.  
  2810.         For the  most part  this is  quite easy  to do  and MAINLY involves
  2811.        quirks in  how you  configure the  second thru  x copies of WILDCAT.
  2812.        LiveCat, in and of itself has  very little to do with the  secondary
  2813.        copy of Wildcat!
  2814.  
  2815.         Running a  second copy  of Wildcat!  is done  in almost exactly the
  2816.        manner as you  would run any  other door.   You install it,  set the
  2817.        attributes, write the script and let it run.  There are some  things
  2818.        that you MUST  be aware of  however in configuring  your second copy
  2819.        of Wildcat!
  2820.  
  2821.        1.) You  MUST disable  the Goodbye  to Logoff  feature in the second
  2822.            WC.
  2823.  
  2824.        2.) You MUST force  the user of the  second copy of WC  to exit back
  2825.            to LiveCat.
  2826.  
  2827.        3.) You MUST NEVER invoke LiveCat again from the second copy of  WC!
  2828.            This means you CANNOT run  doors out of the secondary  copies of
  2829.            WC unless  you install  a completely  seperate livecat directory
  2830.            that will be used ONLY by that second copy.  I DO NOT  recommend
  2831.            that you do this  and I do not  support LiveCat running in  that
  2832.            manner.
  2833.  
  2834.        4.)  LiveCat  nor  the  second  copy  of  WC  will automatically log
  2835.            activity of  the user  in the  MASTER ACTIVITY.LOG,  only in the
  2836.            ACTIVITY.LOG  of  the  second  copy.   If  you wish the activity
  2837.            while in  the second  copy of  WC to  be propagated  back to the
  2838.            master ACTIVITY.LOG you are on your own in figuring a way to  do
  2839.            this.
  2840.  
  2841.         * INSTALLING THE SECOND COPY OF WILDCAT AS A FORUM *
  2842.  
  2843.         Step 1:  Use LsEdit  to CREATE  A NEW  MENU to  hold the selections
  2844.                  of forums you will be offering.
  2845.  
  2846.         Step 2: Install the second copy  of WC into the above menu  exactly
  2847.                 as if it were any other door.   Mark it as a '3' type  door
  2848.                 so  that  the  CALLINFO.BBS  created  by LiveCat is WC 2.xx
  2849.                 compliant.
  2850.  
  2851.  
  2852.  
  2853.  
  2854.  
  2855.        LiveCat Version 3.1             47                     06-09-91
  2856.  
  2857.                 The ONLY field that  has special meaning when  installing a
  2858.                 forum is the  TIME ALLOWED field.  With a normal  door this
  2859.                 field tells how LONG  you will allow a  user to be in  this
  2860.                 door.  You  can limit the  user to a  specific time if  you
  2861.                 want just  by putting  in the  time limit  as you would for
  2862.                 any other door.
  2863.  
  2864.                 More realistically though you want the FORUM to be  treated
  2865.                 more like an extension of the BBS rather than as a  routine
  2866.                 door.  This means you  will probably NOT want to  place any
  2867.                 time limit on the  user as to how  long they can be  in the
  2868.                 forum, within normal BBS time limits of course.
  2869.  
  2870.                 If  you  enter  the  number  0  (zero)  in the time allowed
  2871.                 field, LiveCat will give  the user entering the  FORUM, ALL
  2872.                 THE REMAING DOOR TIME THE USER HAS LEFT for the day!
  2873.  
  2874.         Step 4: Enter the rest of the attribute fields as requested.
  2875.  
  2876.         Step 5: Prepare the execution script.
  2877.  
  2878.                 The execution script for running  the second copy of WC  is
  2879.                 NOT complicated BUT  it IS critical  that it be  absolutely
  2880.                 correct!   Below is an example script that probably can  be
  2881.                 used almost 'as is' on your system.
  2882.  
  2883.  
  2884.            COPY C:\WILDCAT\CALLINFO.BBS C:\CAT2\CALLINFO.BBS
  2885.            CD \CAT2
  2886.            WILDCAT
  2887.            CD \WILDCAT
  2888.  
  2889.               In the above example, the name of the directory that  holds
  2890.               our second copy of WC is: CAT2
  2891.  
  2892.                 In  line  1  of  the  script  we  COPY  the freshly created
  2893.                 CALLINFO.BBS file that LiveCat  just gave us into  the CAT2
  2894.                 directory.
  2895.  
  2896.                 In line 2 we simple change over to that directory
  2897.  
  2898.                 Line 3 is CRITICAL!! You  will notice that we do  NOT start
  2899.                 this  copy  of  Wildcat!  with  a  batch  file.   We invoke
  2900.                 WILDCAT directly without use of the normal CAT.BAT file.
  2901.  
  2902.                 In line  4 we  simply change  back to  the original Wildcat
  2903.                 directory after the user exits the second copy of WC!
  2904.  
  2905.                 Thats all  there is  to configuring  LiveCat to  handle the
  2906.                 second copy..   Wildcat! setup  in this  second copy  is  a
  2907.                 little different however than what you are used to.
  2908.  
  2909.         Understand that  when the  second copy  of Wildcat!  starts up,  it
  2910.         THINKS it's returning from  a door!  This  is because the modem  is
  2911.         already  ON-LINE  and  a  CALLINFO.BBS  is  present.  The second WC
  2912.         reads in this CALLINFO.BBS to  find out WHO it is  that's returning
  2913.  
  2914.  
  2915.  
  2916.  
  2917.  
  2918.  
  2919.        LiveCat Version 3.1             48                     06-09-91
  2920.  
  2921.         from doors!  If you want  a fancy welcome screen to appear  similar
  2922.         to the WELCOME file they see when the first log on to the BBS,  you
  2923.         must put it  in the file  that is displayed  when returning from  a
  2924.         door.
  2925.  
  2926.         From  this  point  on,  operation  of  the  second  copy  of  WC is
  2927.         identical to  the first.   LiveCat is  out of  the picture  at this
  2928.         time and is not in control.
  2929.  
  2930.         Now comes the point in time when the user wishes to either
  2931.           A: Logoff
  2932.               or
  2933.           B: Return to the Main Board or join another forum.
  2934.  
  2935.         Configuring WILDCAT to handle this correctly is important and  MUST
  2936.         be done in MAKEWILD.
  2937.  
  2938.         Makewild allows you to change the KEY STROKES required to  activate
  2939.         any Wildcat command.   What we want to  do is CHANGE the  G command
  2940.         so that it  does NOT LOG  OFF, and, we  want to HIDE  the D that is
  2941.         normally used to display the DOORS.BBS menu.
  2942.  
  2943.         Basically what we want to happen is when the user press G, we  want
  2944.         the DOORS.BBS menu to display because we are going to let them  out
  2945.         of this copy of WC ONLY through the DOORS function of WC.
  2946.  
  2947.          Heres now you do all this in Makewild:
  2948.  
  2949.         Step 1:   Start Makewild and  go to the  screen panel that  has the
  2950.                  commands  keystroke  for  the  WC  main menu, the one that
  2951.                  displays both G for goodbye and D for doors.
  2952.  
  2953.         Step 2:   Move   down  to  the  G  field for goodbye and CHANGE the
  2954.                  keystroke from G to V. (or ANY key that is not already  in
  2955.                  use  by  the  menu).   Next  move  over the security level
  2956.                  field and change the  security level to your  sysop level,
  2957.                  so nobody can execute this hidden command but you.   Since
  2958.                  you set  the level  this high,  this dummy  entry will not
  2959.                  appear in the main menu the user sees.
  2960.  
  2961.         Step 3:   Move  down  to  the  D  field  for  doors and change the
  2962.                  keystroke  from  D  to  G.   Move  to  the level field and
  2963.                  change the  level to  you systems  lowest security  level.
  2964.                  Change the  description of  this command,  whatever it  is
  2965.                  to:
  2966.                                  Go back to LiveCat
  2967.  
  2968.         Step 4:  Go to  the last  sceen of  Makewild and  tell it that you
  2969.                  1 door running.
  2970.  
  2971.         Step 5:  Go  to  the  Makewild  screen  panel in which your Modem
  2972.                  Setup  parameters  are  displayed.  BLANK  OUT  EVERYTHING
  2973.                  having  to  do  with  modem  startup  and   initialization
  2974.                  strings EXCEPT  the comport  number the  system is running
  2975.                  on, the startup baud rate and the DTE locking status.
  2976.  
  2977.  
  2978.  
  2979.  
  2980.  
  2981.  
  2982.  
  2983.        LiveCat Version 3.1             49                     06-09-91
  2984.  
  2985.         Step 6:  Exit Makewild and save the changes.
  2986.  
  2987.         Step 7:  Only two  more steps  and we'll  be done.   You must  now
  2988.                  create a  DOORS.BBS file  that will  be seen  by the  user
  2989.                  when they Press G  from the main menu.   This file can  be
  2990.                  formatted anyway  you want  but it  must contain  ONE line
  2991.                  that tells the user to:
  2992.  
  2993.                  Press 1 to return to LiveCat or Press ENTER to stay here.
  2994.  
  2995.                  The wording can be whatever you want but the idea is  that
  2996.                  we want  the user  to have  only two  choices, leave  this
  2997.                  forum or stay here.
  2998.  
  2999.         Step 8:  Last step.  In the  CAT2 directory,  create a file called
  3000.                 DOOR1.BAT.   In this  file you  put ONE  LINE ONLY  and it
  3001.                 is simply: CLS
  3002.  
  3003.         Thats  it,  your  second  copy  of  WC is configured and should run
  3004.        exactly as you  want it too.   You can configure  as many  secondary
  3005.        copies of WC as you want to in this manner.
  3006.  
  3007.  
  3008.  
  3009.  
  3010.  
  3011.  
  3012.  
  3013.  
  3014.  
  3015.  
  3016.  
  3017.  
  3018.  
  3019.  
  3020.  
  3021.  
  3022.  
  3023.  
  3024.  
  3025.  
  3026.  
  3027.  
  3028.  
  3029.  
  3030.  
  3031.  
  3032.  
  3033.  
  3034.  
  3035.  
  3036.  
  3037.  
  3038.  
  3039.  
  3040.  
  3041.  
  3042.  
  3043.  
  3044.  
  3045.  
  3046.  
  3047.        LiveCat Version 3.1             50                     06-09-91
  3048.  
  3049.        [[ APPENDIX H - LIVECAT AND LSEDIT FUNCTION KEYS ]]
  3050.  
  3051.         When LiveCat is actually running the following functions are
  3052.         active:
  3053.  
  3054.         F1 Key:
  3055.               When LiveCat  is running,  pressing F1  will send  the user a
  3056.               message that the sysop is dropping  to DOS.  You may do  what
  3057.               you need to do  at DOS and then  type EXIT to return  back to
  3058.               monitor.(make  sure   you  CD   back  to   the  \WC30\LIVECAT
  3059.               directory before typing EXIT).
  3060.  
  3061.          F7 Key
  3062.               A new  function key  command has  been added  when LiveCat is
  3063.               running.  The  F7  key  can  now  be  used to change the live
  3064.               program time for  the user currently  on line. This  includes
  3065.               YOU as the sysop. If you find yourself running short on  time
  3066.               while  installing  and  testing  doors,  just hit F7 and give
  3067.               yourself more time.
  3068.  
  3069.          F8 Key
  3070.              Pressing the F8 key while LiveCat is running will IMMEDIATELY
  3071.              terminate the session and return the user to WILDCAT
  3072.  
  3073.          F9 Key
  3074.              Used by the SYSOP to  enter CHAT mode with the  user currently
  3075.              on line.   The user  is NOT  charged time  while in  the  chat
  3076.              mode.
  3077.  
  3078.         ESC Key
  3079.  
  3080.        WHEN USING LSEDIT THE FOLLING FUNCTIONS ARE AVAILABLE:
  3081.  
  3082.        COMMAND DESCRIPTION                            KEY STROKE
  3083.        Backspace Or Delete Previous Character         Backspace
  3084.        Carriage Return Or Next Line                   <CR>
  3085.        Change a String (All,Range,Block)              F6
  3086.        Change a String With Verify (All,Range,Block)  Shift F6
  3087.        Copy a Highlighed Block of Text                Alt C
  3088.        Delete a Highlighted Block of Text             Alt D
  3089.        Delete Current Character                       Del
  3090.        Delete Current Line                            Shift F9
  3091.        Find a String (All,Forward,Backward)           F5
  3092.        Help Screens                                   F1
  3093.        Highlight a Line Block                         F8
  3094.        Highlight a Character Block                    F7
  3095.        Insert a Line After the Current Line           F9
  3096.        Insert a Line Before the Current Line          Ctrl F5
  3097.        Join Next Line At The End Of The Current Line  Alt J
  3098.        Memory Status Display                          Shift F5
  3099.        Move a Highlighted Block of Text               Alt M
  3100.        Page Down                                      PgDn
  3101.        Page Up                                        PgUp
  3102.        Position At the Beginning of the File          Ctrl Home
  3103.        Position At the End of The File                Ctrl End
  3104.        Position At the Beginning of the Line          Home
  3105.        Position At the End of The Line                End
  3106.        Position Down One Line                         Cursor-Down
  3107.        Position On the Next Character                 Cursor-Right
  3108.        Position On the Previous Character             Cursor-Left
  3109.        Position On the Next Word                      Ctrl ->
  3110.  
  3111.        LiveCat Version 3.1             51                     06-09-91
  3112.  
  3113.        Position On the Previous Word                  Ctrl <-
  3114.        Position Up One Line                           Cursor-Up
  3115.        Quit the Current File                          Ctrl F3
  3116.        Save the Current File and Continue Editing     Shift F3
  3117.        Save the Current File and Quit the file        F3
  3118.        Split Current Line At Current Position         Alt S
  3119.        Tab Toward                                     Right Tab
  3120.        Tab Toward Left                                Shift Tab
  3121.        Toggle Between Insert/Replace Mode             Ins
  3122.  
  3123.  
  3124.  
  3125.  
  3126.  
  3127.  
  3128.  
  3129.  
  3130.  
  3131.  
  3132.  
  3133.  
  3134.  
  3135.  
  3136.  
  3137.  
  3138.  
  3139.  
  3140.  
  3141.  
  3142.  
  3143.  
  3144.  
  3145.  
  3146.  
  3147.  
  3148.  
  3149.  
  3150.  
  3151.  
  3152.  
  3153.  
  3154.  
  3155.  
  3156.  
  3157.  
  3158.  
  3159.  
  3160.  
  3161.  
  3162.  
  3163.  
  3164.  
  3165.  
  3166.  
  3167.  
  3168.  
  3169.  
  3170.  
  3171.  
  3172.  
  3173.  
  3174.  
  3175.        LiveCat Version 3.1             52                     06-09-91
  3176.  
  3177.        [[ APPENDIX I - USING OPTIONAL ANSI AND ASCII MENUS ]]
  3178.  
  3179.         With version  3.1 you  may now  create Ansi  color, and Ascii menus
  3180.        for LiveCat  with THEDRAW  or some  other ansi  drawing program  and
  3181.        with a standard text editor.
  3182.  
  3183.         The naming conventions of these  menus are what is most  important,
  3184.        and you  may have  either/or/both ansi  and ascii  menus for EACH of
  3185.        your LiveCat menus.
  3186.  
  3187.         As an example, lets  say that you wish  to create both an  ANSI and
  3188.        an ASCII menu file for a LiveCat menu name WARGAMES:
  3189.  
  3190.         1.) The files names must match the name of the MENU. and MUST  have
  3191.             the  proper  file  name  extensions.  For  instance,  for  your
  3192.             WARGAMES  menu  your  ANSI  COLOR  menu  file   must  be  named
  3193.             WARGAMES.SCR and  MUST be  present in  your LIVECAT  directory.
  3194.             The name of the ASCII menu file would be WARGAMES.BBS
  3195.  
  3196.         2.) When you create your  external menus, they should be  NO LONGER
  3197.             than  21  or  22  lines  and  should  be no wider than 78 or 79
  3198.             characters so  that they  will format  correctly when displayed
  3199.             so  the  user  doesn't  have  to  deal with unsightly pauses to
  3200.             press enter to continue the menu display.
  3201.  
  3202.         Use of these menus are optional and you need NOT have one for  EACH
  3203.        of your menus.   If there is NOT  an external menu file  present for
  3204.        the menu, LiveCat will use  the standard format internal menus.   If
  3205.        there ARE  external menu  files available,  LiveCat will  sense them
  3206.        and pick them up and use them when and where they are needed.
  3207.  
  3208.  
  3209.  
  3210.  
  3211.  
  3212.  
  3213.  
  3214.  
  3215.  
  3216.  
  3217.  
  3218.  
  3219.  
  3220.  
  3221.  
  3222.  
  3223.  
  3224.  
  3225.  
  3226.  
  3227.  
  3228.  
  3229.  
  3230.  
  3231.  
  3232.  
  3233.  
  3234.  
  3235.  
  3236.  
  3237.  
  3238.  
  3239.        LiveCat Version 3.1             53                     06-09-91
  3240.  
  3241.        [[ APPENDIX J - LIVECAT UTILITY AND SUPPORT PROGRAMS ]]
  3242.  
  3243.         For a variety  of reasons,   system crashes, hung  doors etc   etc,
  3244.        your LiveCat Doors Database  may become corrupted and  inaccessible.
  3245.        This  is  usually  manifested  by  either   LiveCat or LsEdit giving
  3246.        Error  #14 when trying to start up.
  3247.  
  3248.         This is really  not cause for  alarm, it generally  just means that
  3249.        the Isam Database was left  in an ambiguous condition the  last time
  3250.        it was used.
  3251.  
  3252.         Registered  users  receive  a utility  program to assist in the
  3253.        repair of a corrupted Doors Database, LSRBLD.EXE.
  3254.  
  3255.        LSRBLD.EXE is a utility program  that should be run ONLY  if LiveCat
  3256.        or LsEdit begins reporting error #14 on file xxx during startup.
  3257.  
  3258.         If LSRBLD.EXE  needs to  be run,  you MUST  do it  from a NODE HOME
  3259.        directory, NOT the  LIVECAT directory, always  run ANY .EXE  program
  3260.        associated with LiveCat  from a NODE  HOME directory, the  directory
  3261.        where a MONITOR.CFG  file is located  OR, the program  run will fail
  3262.        at  best,  and  at  worst  can  make  an otherwise simple corruption
  3263.        problem much worse.
  3264.  
  3265.  
  3266.  
  3267.  
  3268.  
  3269.  
  3270.  
  3271.  
  3272.  
  3273.  
  3274.  
  3275.  
  3276.  
  3277.  
  3278.  
  3279.  
  3280.  
  3281.  
  3282.  
  3283.  
  3284.  
  3285.  
  3286.  
  3287.  
  3288.  
  3289.  
  3290.  
  3291.  
  3292.  
  3293.  
  3294.  
  3295.  
  3296.  
  3297.  
  3298.  
  3299.  
  3300.  
  3301.  
  3302.  
  3303.        LiveCat Version 3.1             54                     06-09-91
  3304.  
  3305.         [[ APPENDIX K - DOOR HINTS AND TIPS ]]
  3306.  
  3307.         Because of  the 'tricky'  nature of  some doors,  it's pretty  much
  3308.        impossible to say that  LiveCat can run them  ALL, but it DOES  come
  3309.        close.   The unfortunate  reality is  that many  doors out there are
  3310.        written  by  amature  programmers  who  many times are just learning
  3311.        programming and as a  result, many of the  doors you will work  with
  3312.        won't behave  in a  totally predicatable  manner.   Each type  has a
  3313.        particular set of  quirks associated with  it and until  you've used
  3314.        doors long enough to recognize  the ones done in various  door kits,
  3315.        and the  inherent problems  built in  to them,  doors can  be a  bit
  3316.        frustrating.
  3317.  
  3318.         If I happen to mention a  door in this document as being  'tricky',
  3319.        'quirky' or 'difficult', it is NOT a slam at the author OR the  door
  3320.        and does NOT mean  you should not consider  it for use on  your BBS.
  3321.        It simply means that it  doesn't behave in exactly the  manner you'd
  3322.        expect and  some special  tricks have  to be  employed in LiveCat to
  3323.        get it running.   With some persistance, I've  not yet found a  door
  3324.        that  I  couldn't  get  running  provided  of  course  the door is a
  3325.        working piece of software.
  3326.  
  3327.         I don't recommend  that you use  'carrier watchers' in  your system
  3328.        such as Watchdog  because the reboot  forced by them  does not allow
  3329.        any user information   to be updated.   My opinion is  that you  are
  3330.        better off to  take those doors  completely out of your system  that
  3331.        hang themselves  up  on  a carrier   drop.  BUT,   if you wanted  to
  3332.        run watchdog in the above script it would look like this:
  3333.  
  3334.               watchdg1 ON
  3335.               cd \doors\tw500m
  3336.               tw2
  3337.               watchdg1 OFF
  3338.  
  3339.          Again, very simple!  Remember, any DOS command can be included in
  3340.        the script such as commands to copy files back and forth and so on.
  3341.  
  3342.  
  3343.        NOTE: If you DO run watchdog with any of your doors you will NOT be
  3344.              able to run them in LOCAL mode from LiveCat.
  3345.  
  3346.  
  3347.        NOTE:
  3348.             In the case  that a user  should drop carrier  while inside one
  3349.             of the doors, LiveCat IS smart  enough to catch them at it  and
  3350.             still get  their time  use records  updated if  Watchdog is NOT
  3351.             used.  As the door program senses that carrier was dropped  and
  3352.             shuts itself down, LiveCat  intercepts the exit and  recognizes
  3353.             that carrier was dropped and  goes ahead and updates the  users
  3354.             time record  and then  recycles WILDCAT.   If you  use watchdog
  3355.             this feature is defeated. Be aware however that are  conditions
  3356.             under which  a door  can lock  up and  not release  itself from
  3357.             memory.  This happens most  often to doors that are  written in
  3358.             Basic.   They  will  hang  up  when  the  BRUN  runtime support
  3359.             package reports an error and will not release until a  carriage
  3360.             return is entered  from the local  keyboard.  This  is the kind
  3361.             of thing that Watchdog  can catch and LiveCat  cannot, although
  3362.             many times even Watchdog is unable to act when this happens.
  3363.  
  3364.  
  3365.  
  3366.  
  3367.        LiveCat Version 3.1             55                     06-09-91
  3368.  
  3369.          I get asked many questions about 'How can I run non-door  programs
  3370.          as a door?'.  This CAN be done in many cases, but NOT directly  by
  3371.          LiveCat.  LiveCat does NOT provide external comm port services  to
  3372.          other programs.  In order to run non-door software as a door,  I'd
  3373.          strongly suggest you investigate the use of an excellent piece  of
  3374.          software called Doorway.   Doorway provides many features,  one of
  3375.          which is External Comm Port  services and it can be  configured to
  3376.          run  a  surprising  number  of  non-door  programs  in  an on-line
  3377.          environment.  I  strongly recommend it  as a companion  product to
  3378.          LiveCat.   If  you  elect  to  use  Doorway  to  run  this type of
  3379.          software, Doorway is run from a standard LiveCat script as is  any
  3380.          other door program in your system.  A bit of experimentation  will
  3381.          get you going, ALTHOUGH, I  don't really recommend trying this  if
  3382.          you have not had a lot experience with doors.  Get your  knowledge
  3383.          base built up a bit and then have a go at it.  The results can  be
  3384.          quite surprising.
  3385.  
  3386.  
  3387.  
  3388.  
  3389.  
  3390.  
  3391.  
  3392.  
  3393.  
  3394.  
  3395.  
  3396.  
  3397.  
  3398.  
  3399.  
  3400.  
  3401.  
  3402.  
  3403.  
  3404.  
  3405.  
  3406.  
  3407.  
  3408.  
  3409.  
  3410.  
  3411.  
  3412.  
  3413.  
  3414.  
  3415.  
  3416.  
  3417.  
  3418.  
  3419.  
  3420.  
  3421.  
  3422.  
  3423.  
  3424.  
  3425.  
  3426.  
  3427.  
  3428.  
  3429.  
  3430.  
  3431.        LiveCat Version 3.1             56                     06-09-91
  3432.  
  3433.        [[ COMMON PROBLEMS, SOLUTIONS, QUESTIONS AND ANSWERS ]]
  3434.  
  3435.        Q: When I or a user preses Z for a menu change all they see is a
  3436.           blank screen.
  3437.  
  3438.        A: You have either not created or you have misnamed your MENU.BBS
  3439.           and MENU.ANS menu screens.  These two menus are what are
  3440.           displayed to users as the menu category choices when the Z key
  3441.           is pressed.
  3442.  
  3443.        Q: I have the door marked Y to UNLOCK the DTE when it runs but when
  3444.           door tries to run it gives the user garbage, or it errors with
  3445.           an error message saying it cannot place modem in command mode.
  3446.  
  3447.        A: Your modem is configured incorrectly.  Make sure that if you are
  3448.           using an HST that dip switch #9 is DOWN. AND that you have
  3449.           included S2=1 in your modem setup string, and if necessary,
  3450.           saved it to your modem NRAM with AT&W.  OR you did not enter the
  3451.           correct LOCKED DTE RATE in the CONFIGURATION menu of LsEdit.
  3452.  
  3453.        Q: If I drop to dos from the BBS or LiveCat and try to run LSEDIT
  3454.           it gives error messages.
  3455.  
  3456.        A: LsEdit requires approximately 340k of free memory to operate.
  3457.           If you do not have AT LEAST this much free memory available when
  3458.           you drop to dos, you will NOT be able to run LsEdit in this
  3459.           manner.
  3460.  
  3461.        Q: My PCBoard doors won't run.
  3462.  
  3463.        A: This is a tough one since so many things effect the running of
  3464.           PCB doors.  First things to check are that you have the
  3465.           LSFIP.EXE program located in either the WILDCAT directory OR a
  3466.           directory that is in a dos search path.  If LSFIP.EXE cannot be
  3467.           run by LiveCat, none of the pcboard support files will be
  3468.           created and your PCB doors will not function. If this does not
  3469.           solve the problem, go back and reread APPENDIX F carefully.
  3470.  
  3471.        Q: When either LiveCat or LsEdit startup they give an ERROR #14 on
  3472.           FILE x message.
  3473.  
  3474.        A: Something has corrupted your Isam database.  Run LSRBLD.EXE from
  3475.           the WILDCAT directory and then immediately run LSPACK.EXE to
  3476.           reconstruct the corrupted database.  Some data loss may have
  3477.           occurred.
  3478.  
  3479.        Q: When I install a new door into a menu, it goes into the menu
  3480.           somplace other than at the end and I have to edit all of my ansi
  3481.           an ascii menus.
  3482.  
  3483.        A: This is an unavoidable side effect of the Isam Data Base in use.
  3484.           Doors are inserted into the menus usually on an Alphabetical by
  3485.           door name basis but this is not TOTALLY predicable because of
  3486.           the way the system reuses index nodes.
  3487.  
  3488.  
  3489.  
  3490.  
  3491.  
  3492.  
  3493.  
  3494.  
  3495.        LiveCat Version 3.1             57                     06-09-91
  3496.  
  3497.        [[ LIVECAT REGISTRATION INFORMATION ]]
  3498.  
  3499.          Steve Cox
  3500.          Flite-Line BBS
  3501.          3800 Old Cheney Road
  3502.          Suite 101-133
  3503.          Lincoln, Ne. 68516
  3504.  
  3505.          FLITE-LINE BBS
  3506.          DATA 402-421-2434  300/1200/2400/9600 USR  (NODE 1)
  3507.          DATA 402-421-1171  300/1200/2400    (NODE 2)
  3508.          DATA 402-421-1376  300/1200/2400    (NODE 3)
  3509.  
  3510.          Registration:  Single User WildFire 3.5 for Spitfire 3.x   $30.00
  3511.                         Single User LiveCat 3.5  for Wildcat 2 & 3   30.00
  3512.                         Single User LivePro 3.5  for GAP 5.x         30.00
  3513.                         Single User SuperDor 3.5 for PCBoard 14.x    30.00
  3514.                         LiveCat  3.5/M2 (2 node Wildcat 2.xx & 3.xx) 40.00
  3515.                         LiveCat  3.5/M5 (5 node Wildcat 2.xx & 3,xx) 45.00
  3516.                         LiveCat  3.5/M+ (99 node Wildcat 2.xx & 3.xx)50.00
  3517.                         LivePro  3.5/M2 (2 node GAP 5.x )            40.00
  3518.                         LivePro  3.5/M5 (5 node GAP 5.x )            45.00
  3519.                         LivePro  3.5/M+ (99 node GAP 5.x)            50.00
  3520.                         SuperDor 3.5/M2 (2 node PCB 14.x)            40.00
  3521.                         SuperDor 3.5/M5 (5 node PCB 14.x)            45.00
  3522.                         SuperDor 3.5/M+ (99 node PCB 14.x)           50.00
  3523.                         WildFire 3.5/M2 (2 node Spitfire 3.x)        40.00
  3524.                         WildFire 3.5/M5 (5 node Spitfire 3.x)        45.00
  3525.                         WildFire 3.5/M+ (99 node Spitfire 3.x)       50.00
  3526.  
  3527.          UPGRADE PRICES:
  3528.  
  3529.              LiveCat 3.5s to LiveCat 3.5/M2   10.00
  3530.              LiveCat 3.5s to LiveCat 3.5/M5   15.00
  3531.              LiveCat 3.5s to LiveCat 3.5/M+   20.00
  3532.  
  3533.              LivePro 3.5s to LivePro 3.5/M2   10.00
  3534.              LivePro 3.5s to LivePro 3.5/M5   15.00
  3535.              LivePro 3.5s to LivePro 3.5/M+   20.00
  3536.  
  3537.              SuperDor 3.5 to SuperDor 3.5/M2 10.00
  3538.              SuperDor 3.5 to SuperDor 3.5/M5 15.00
  3539.              SuperDor 3.5 to SuperDor 3.5/M+ 20.00
  3540.  
  3541.              WildFire 3.5 to WildFire 3.5/M2 10.00
  3542.              WildFire 3.5 to WildFire 3.5/M5 15.00
  3543.              WildFire 3.5 to WildFire 3.5/M+ 20.00
  3544.  
  3545.  
  3546.  
  3547.  
  3548.  
  3549.  
  3550.  
  3551.  
  3552.  
  3553.  
  3554.  
  3555.  
  3556.  
  3557.  
  3558.  
  3559.        LiveCat Version 3.1             58                     06-09-91
  3560.  
  3561.        [[ LIVECAT REGISTRATION FORM ]]
  3562.                              Registration Information
  3563.                              ~~~~~~~~~~~~~~~~~~~~~~~~
  3564.                          Live Systems Registration Form
  3565.  
  3566.  
  3567.          Name : _____________________________________________________
  3568.  
  3569.          Address : __________________________________________________
  3570.  
  3571.          Address : __________________________________________________
  3572.  
  3573.          City,State,Zip : ___________________________________________
  3574.  
  3575.          Voice Phone : ______________________________________________
  3576.  
  3577.          BBS Name: __________________________________________________
  3578.  
  3579.          BBS Number: ________________________________________________
  3580.  
  3581.          Comments: --------------------------------------------------
  3582.             --------------------------------------------------
  3583.             --------------------------------------------------
  3584.  
  3585.          Version of Wildcat! you are running? __________
  3586.  
  3587.  
  3588.          Live Systems product you wish to register from the price list:
  3589.  
  3590.          Quan:    Description     Price
  3591.  
  3592.          ------   ---------------------------------    ----------
  3593.          ------   ---------------------------------    ----------
  3594.          ------   ---------------------------------    ----------
  3595.  
  3596.                      Total ----------
  3597.  
  3598.              Allow 2-3 Weeks for Delivery
  3599.  
  3600.          Shipped on 1.2m HD 5 1/2" Floppy unless otherwise specified 
  3601.  
  3602.          ------------------------------------------------------------ 
  3603.           Payment may be made by check or money order
  3604.          ------------------------------------------------------------
  3605.  
  3606.               Steve Cox
  3607.               Live Systems
  3608.               3800 Old Cheney Road
  3609.               Suite 101-133
  3610.               Lincoln, Ne.  68516
  3611.  
  3612.  
  3613.  
  3614.  
  3615.  
  3616.  
  3617.  
  3618.  
  3619.  
  3620.  
  3621.  
  3622.  
  3623.        LiveCat Version 3.1             59                     06-09-91
  3624.  
  3625.  
  3626.  
  3627.  
  3628.  
  3629.  
  3630.  
  3631.  
  3632.  
  3633.  
  3634.  
  3635.  
  3636.  
  3637.  
  3638.  
  3639.  
  3640.  
  3641.  
  3642.  
  3643.  
  3644.  
  3645.  
  3646.  
  3647.  
  3648.  
  3649.  
  3650.  
  3651.  
  3652.  
  3653.  
  3654.  
  3655.  
  3656.  
  3657.  
  3658.  
  3659.  
  3660.  
  3661.  
  3662.  
  3663.  
  3664.  
  3665.  
  3666.  
  3667.  
  3668.  
  3669.  
  3670.  
  3671.  
  3672.  
  3673.  
  3674.  
  3675.  
  3676.  
  3677.  
  3678.  
  3679.  
  3680.  
  3681.  
  3682.  
  3683.  
  3684.  
  3685.  
  3686.  
  3687.        LiveCat Version 3.1             60                     06-09-91
  3688.